Companies

Get company by its registry number

Changed on

Fetch a company profile by the customer's own number instead of our id: GET /companies/{country}/{company_number}, for example /companies/ES/A28015865 (NIF), /companies/FR/552120222 (SIREN; a 14-digit SIRET also works), /companies/GB/00445790, /companies/PL/0000028860 (KRS), /companies/DK/12345678 (CVR). The number is resolved exactly as /companies/search?country=&company_number= resolves it (same validators: a malformed number is a 400 validation_error with an X-Error-Code header), then the answer is exactly what GET /companies/{id}?country= returns, with include= and the other query parameters of that route. Costs 1 credit. Nothing found is a 404 not_found. A number that more than one company carries (US registers repeat numbers across states, a German commercial-register entry repeats across courts) is a 409 ambiguous_company_number with error.candidates (id, company_name, company_number, status, country); fetch the one you mean with GET /companies/{id}?country=. 409 rather than 300 because HTTP clients treat a 3xx as a redirect to follow, and the situation is a conflict the caller must resolve, not a choice the server may make.

get/companies/{country}/{company_number}

Request

  • Base URL: https://api.prometiam.com/functions/v1/risk-api
  • URL: https://api.prometiam.com/functions/v1/risk-api/companies/{country}/{company_number}
  • Auth: HTTP bearer

Path parameters

countrystring required

Two-letter country code of a live registry country (ES, FR, GB, ...), upper or lower case.

company_numberstring required

The register's number for the country: NIF/CIF (ES), SIREN or SIRET (FR), company number (GB, IE), KRS (PL), organisation number (NO), CVR (DK), and so on; for a German commercial-register entry (HRB12653) encode a slash as %2F.

Query parameters

includestring

Comma-separated extra blocks to attach: procurement, insolvency, financials, lei, risk_flags, structure — or all (which adds lei and risk_flags; procurement, insolvency, financials and structure are named explicitly). structure adds corporate_structure, the company's direct and ultimate parent as reported to GLEIF (Level 2, CC0), for a company of any live country that carries a Legal Entity Identifier; null with a meta.notice when no LEI is linked to the company (not reported, not no parent). financials adds latest_financials, the latest current annual statement (same shape as one entry of GET /companies/{id}/financials; the company's own before its group's) for GB, FR, DK, SE and NO, for FI (statements filed digitally with PRH, and listed groups) for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), for US SEC filers, EE, LT and RO (headline figures), LV, CO (Superintendencia de Sociedades filers) and BR (listed companies), and for listed companies in ES, PL, HR and BE, for keys with the financials scope (Scale plan and above); for other keys the field is left out with a meta.notice, and for other countries it is null with a notice. Annual accounts as filed (outside France, digitally filed accounts only); see GET /companies/{id}/financials for the scope limits. procurement adds the company's latest awards for ES, FR, GB, IE, PL and NO (procurement.top_awards). insolvency adds the Spanish concurso proceedings from the BORME entries for ES (insolvency_proceedings) and the corporate insolvency notices linked by registry number for FR, GB, NO, FI, DK, HR, SE, CH, LV and EE (insolvency_notices; a Swiss notice only where it names the debtor's UID). A block a country does not carry is named in meta.notice; a block that could not be read is null with a meta.notice (unknown, not empty). risk_flags returns two kinds of entry: registry_compliance (ES, GB, IE, NO), the register's own signal that the company has stopped meeting its filing duties (signal = sheet_closed, strike_off_proposed, accounts_overdue, strike_off_listed or forced_dissolution, dated in as_of), and the Spain-only AEAT tax-debtor entries (tax_debt), which are point-in-time and OCR-derived, each stating via identifier_source whether its identifier was read directly from the source or reconstructed with name corroboration.

appointments_limitinteger

Officer appointments returned, 1 to 500 (default 100). Current appointments (no end date, not a cessation) come first, then the history, each newest first, so the default page holds every current officer of a company that has up to 100. Outside the range is a 400 validation_error; it is never clamped.

appointments_offsetinteger

Appointments to skip in the current-first order, an integer of 0 or more.

events_limitinteger

Recent corporate events returned, 1 to 200 (default 25). Outside the range is a 400 validation_error.

events_offsetinteger

Events to skip, an integer of 0 or more.

Response

Company detail

Example response

{
  "data": {
    "id": 2000099999001,
    "country": "GB",
    "company_number": "09999001",
    "company_name": "EXAMPLE HARBOUR TRADING LTD",
    "previous_names": [
      {
        "name": "EXAMPLE QUAY SUPPLIES LTD",
        "from_date": "2016-03-01",
        "until_date": "2021-06-14"
      }
    ],
    "identifiers": [
      {
        "type": "crn",
        "value": "09999001"
      }
    ],
    "vat_number": null,
    "vat_number_source": null,
    "lei": null,
    "legal_form": "LTD",
    "legal_form_family": "private_limited_company",
    "local_legal_form": "ltd",
    "local_legal_form_name": "Private limited company",
    "status": "active",
    "stage": "active",
    "local_status": "active",
    "status_date": null,
    "founding_date": "2016-03-01",
    "registration_date": null,
    "dissolution_date": null,
    "activity_code": "46900",
    "activity_code_scheme": "UK-SIC-2007",
    "activity_description": "Non-specialised wholesale trade",
    "activity_description_en": "Non-specialised wholesale trade",
    "nace_class": "46.90",
    "nace_version": "2",
    "secondary_activity_codes": [
      {
        "code": "52290",
        "scheme": "UK-SIC-2007",
        "description": "Other transportation support activities"
      }
    ],
    "business_purpose": null,
    "address": "1 EXAMPLE WHARF, LONDON, E1 0AA",
    "postal_code": "E1 0AA",
    "city": "LONDON",
    "municipality": null,
    "region": "GREATER LONDON",
    "address_country": "GB",
    "capital_amount": null,
    "capital_currency": null,
    "capital_eur": null,
    "employees": null,
    "employee_band": null,
    "website": null,
    "website_source": null,
    "register": "Companies House",
    "first_seen_date": "2026-01-15",
    "last_seen_date": "2026-10-14",
    "updated_at": "2026-10-14T03:12:44+00:00",
    "registry_details": {
      "jurisdiction": "ENGLAND-WALES",
      "next_accounts_due": "2027-06-30",
      "next_confirmation_due": "2027-03-28",
      "address_line1": "1 EXAMPLE WHARF",
      "address_line2": null
    }
  }
}

Changes