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.

Kontrata ng source

Publisher: Companies House, United Kingdom
Saklaw: Corporate bodies in the Companies House basic-data product.
Kahulugan ng tala: 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.
Tinatanggap na pattern: ^[A-Z0-9]{8}$
Bilang ng mga tala: one
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

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

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

company-numberstringpathkailangan

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

Example: 00445790

Halimbawa ng request

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

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

company-number string kailangan

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

legal_name string kailangan

Registered name published by the authority.

status string kailangan

Publisher status; not a Latinfo risk rating.

company_category string kailangan

Companies House corporate-body category.

incorporation_date string kailangan

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

sic_code_1 string kailangan

First SIC code and description as published.

sic_code_2 string kailangan

Second SIC code and description, if supplied.

sic_code_3 string kailangan

Third SIC code and description, if supplied.

sic_code_4 string kailangan

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.