English
EspañolEnglishPortuguêsFilipino
Get free API key
United Kingdom · gb_companies_house_register_company_number
OpenAPI

Lookup companies-house · register by COMPANY-NUMBER

GET https://api.latinfo.dev/gb/companies-house/register/company-number/{company-number}

A company registration with published category and SIC attributes. Coverage: Corporate bodies in the Companies House basic-data product. Lookup by company-number as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. This dataset does not supply officers, shareholders or beneficial owners. Returns one record. Import time is not observation time; inspect freshness headers.

Source contract

Publisher
Companies House, United Kingdom
Coverage
Corporate bodies in the Companies House basic-data product.
Record meaning
A company registration with published category and SIC attributes.
Identifier
Lookup by company-number as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Accepted pattern
^[A-Z0-9]{8}$
Cardinality
one
License
Reuse permission has not been verified. Public access is not a reuse license.

Known limitations

  • This dataset does not supply officers, shareholders or beneficial owners.

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

company-numberstringpathrequired

COMPANY-NUMBER in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: 00445790

Request example

curl https://api.latinfo.dev/gb/companies-house/register/company-number/00445790 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Responses

200Published source records. Missing data is not a clearance or a negative finding.

Response headers

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

Content-Type: application/json

Response fields

company-number string required

Lookup by company-number as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.

legal_name string required

Registered name published by the authority.

status string required

Publisher status; not a Latinfo risk rating.

company_category string required

Companies House corporate-body category.

incorporation_date string required

Published incorporation date date. Format: DD/MM/YYYY.

sic_code_1 string required

First SIC code and description as published.

sic_code_2 string required

Second SIC code and description, if supplied.

sic_code_3 string required

Third SIC code and description, if supplied.

sic_code_4 string required

Fourth SIC code and description, if supplied.

Response schema
{
  "type": "object",
  "properties": {
    "company-number": {
      "type": "string",
      "description": "Lookup by company-number as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "legal_name": {
      "type": "string",
      "description": "Registered name published by the authority.",
      "x-latinfo-meaning": "text"
    },
    "status": {
      "type": "string",
      "description": "Publisher status; not a Latinfo risk rating.",
      "x-latinfo-meaning": "text"
    },
    "company_category": {
      "type": "string",
      "description": "Companies House corporate-body category.",
      "x-latinfo-meaning": "text"
    },
    "incorporation_date": {
      "type": "string",
      "description": "Published incorporation date date. Format: DD/MM/YYYY.",
      "x-latinfo-meaning": "date"
    },
    "sic_code_1": {
      "type": "string",
      "description": "First SIC code and description as published.",
      "x-latinfo-meaning": "text"
    },
    "sic_code_2": {
      "type": "string",
      "description": "Second SIC code and description, if supplied.",
      "x-latinfo-meaning": "text"
    },
    "sic_code_3": {
      "type": "string",
      "description": "Third SIC code and description, if supplied.",
      "x-latinfo-meaning": "text"
    },
    "sic_code_4": {
      "type": "string",
      "description": "Fourth SIC code and description, if supplied.",
      "x-latinfo-meaning": "text"
    }
  },
  "required": [
    "company-number",
    "legal_name",
    "status",
    "company_category",
    "incorporation_date",
    "sic_code_1",
    "sic_code_2",
    "sic_code_3",
    "sic_code_4"
  ],
  "additionalProperties": false
}
400Invalid identifier or query. Correct the input before retrying.
No response body documented.
401Missing or invalid API key. Authenticate before retrying.
No response body documented.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No response body documented.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No response body documented.
503Source unavailable. Report unavailable, not an empty result.
No response body documented.
Example JSON

Illustrative schema example. This is not a live response.

{
  "company-number": "string",
  "legal_name": "string",
  "status": "string",
  "company_category": "string",
  "incorporation_date": "string",
  "sic_code_1": "string",
  "sic_code_2": "string",
  "sic_code_3": "string",
  "sic_code_4": "string"
}

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.

Esc