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.

Contrato da fonte

Publicador: Companies House, United Kingdom
Cobertura: Corporate bodies in the Companies House basic-data product.
Significado do registro: A company registration with published category and SIC attributes.
Identificador: Lookup by company-number as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Padrão aceito: ^[A-Z0-9]{8}$
Quantidade de registros: one
Licença: A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

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

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

company-numberstringpathobrigatório

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

Example: 00445790

Exemplo de requisição

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

Respostas

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

Cabeçalhos da resposta

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

Campos da resposta

company-number string obrigatório

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

legal_name string obrigatório

Registered name published by the authority.

status string obrigatório

Publisher status; not a Latinfo risk rating.

company_category string obrigatório

Companies House corporate-body category.

incorporation_date string obrigatório

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

sic_code_1 string obrigatório

First SIC code and description as published.

sic_code_2 string obrigatório

Second SIC code and description, if supplied.

sic_code_3 string obrigatório

Third SIC code and description, if supplied.

sic_code_4 string obrigatório

Fourth SIC code and description, if supplied.

Esquema de resposta

{
  "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.