API documentation
Company identifiers by country
Every country is served through the same endpoints and response shapes, and each takes its own register number in company_number, written as the register prints it. A malformed identifier of the country asked is a 400 validation_error, never an empty 200.
Card required, nothing charged for 14 days. 500 credits over the trial.
The register number each country uses
| Country | Identifier in company_number |
|---|---|
| ES | NIF/CIF (also nif), with the control character |
| FR | SIREN (9 digits) or SIRET (14 digits) |
| GB | Companies House number |
| IE | CRO number |
| PL | KRS number (also NIP and REGON with check digits) |
| NO | Organisation number |
| FI | Y-tunnus, for example 0112038-9 |
| SE | Organisationsnummer, for example 556012-5790 |
| HR | MBS, or the OIB (oib) |
| BE | Enterprise number, for example 0417.497.106 |
| DK | CVR number |
| EE | Registry code |
| SK | IČO |
| CH | UID, for example CHE-103.867.266 |
| LV | Registration number |
| CY | Registration number, for example HE165 |
| RO | CUI |
| US | State registration number, CIK or LEI |
| LT | Legal entity code |
| CA | Corporation number (or the Business Number with business_number) |
| AU | ACN or ARBN (or the ABN with abn) |
| JP | Corporate number |
| IL | Company number |
| BR | CNPJ, or its 8-digit root |
| CO | NIT |
| SG | UEN |
| TW | Unified business number |
| CZ | IČO |
The remaining live countries, and the rules for each identifier, are in the full reference under Countries and identifiers.
Without a country
With a VAT number or an LEI you need no country: GET /companies/by-identifier works out the country and answers like a company record (1 credit). GET /vat/{number} checks an EU VAT number against VIES, which has no NO or CH numbers.
Check digits
Where a country's identifier has a check digit, the API verifies it when the check is enforced and a wrong one is a 400; where the check is advisory (for example IL, CA, TW, CZ, HR, DK, SK), only a malformed number is refused. The per-country rule is listed in the reference.
The VAT number on a company
vat_number and vat_number_source are on every company object. register means the register publishes it or confirms the registration; rule means the number is built from the company's identifier, so the format is right but the registration is not confirmed. It is null where the register says the company is not VAT-registered or where no rule exists.
Limits
- Which records each register publishes differs by country; the country guides and the reference state each country's scope.
- Insolvency notices are corporate only, in sixteen markets (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG); a result with no notice is not proof of solvency.
This page is a short guide; the full reference has every parameter and response, and openapi.json is the machine-readable specification.