Request a company verification
On this page, you will learn how to initiate a new company verification using the API.
To initiate the company verification process from a company number for companies registered in : France, United Kingdom, Belgium, Switzerland or Netherlands you can choose to send a company identification number using the following endpoint or a company identification file, using the following endpoint for France:
Requesting a Company Verification from a company identification number
POST /verifications/companies
{
"company_number": "794513986",
"country_code": "FR",
"workspace_id": null
}{
"id": "3e5a33c0-0c33-4110-89d0-1ca536655d09",
"workspace_id": "6ed2772f-8d7e-4f67-ab2a-790a1dce2adc",
"created_at": "2025-03-31T09:25:11+00:00",
"updated_at": "2025-03-31T09:25:11+00:00",
"status": "pending",
"data": {
"company_information": {
"name": null,
"trade_name": null,
"company_number": null,
"legal_form": {
"code": null,
"description": null
},
"vat_number": null,
"partial_data":null,
"activities": [],
"founded_on": null,
"ceased_on": null,
"active": null,
"commercial_registration": {
"location": null,
"registered_on": null
},
"has_workforce": null
},
"headquarter": {
"address_line_1": null,
"address_line_2": null,
"postal_code": null,
"city": null,
"country_code": null
},
"legal_representatives": []
}
}Before making a request, please make sure to select the correct country based on the type of company number you are entering. Each country supports a specific format, as detailed below:
| Country | Format | Description | Example |
|---|---|---|---|
| France (FR) | SIREN | 9-digit number issued by INSEE | 794513986 |
| Belgium (BE) | Enterprise Number | 10-digit number from the Crossroads Bank for Enterprises | 0223.459.690 |
| Switzerland (CH) | UID | 9-digit business ID from the Federal Statistical Office | 396.664.102 |
| United Kingdom (GB) | CRN (Company Registration Number) | 8-digit number, or 2 letters followed by 6 digits, issued by Companies House | RC000057 |
| Netherlands (NL) | KVK | 8-digit number issued by Kamer van Koophandel | 17001910 |
In the response, you'll find the id. This value is required to retrieve the verification results.
Requesting a Company Verification for a company registered in Germany (DE).
Initiating a company verification for German Companies
POST /verifications/companies
{
"company_number": "HRB-1234",
"country_code": "DE",
"company_name" : "Pitch Software GmbH",
"workspace_id": null
}{
"id": "c1837e50-0d88-404b-a319-619ba8f315bd",
"workspace_id": "7e7895fe-f647-47d0-9a75-da811834d092",
"created_at": "2025-10-30T14:41:25+00:00",
"updated_at": "2025-10-30T14:41:25+00:00",
"status": "pending",
"data_anonymized": false,
"data": {
"extracted_from_document": {
"company_number": null,
"issued_on": null
},
"company_information": {
"name": null,
"trade_name": null,
"company_number": null,
"legal_form": {
"code": null,
"description": null
},
"vat_number": null,
"partial_data": null,
"activities": [],
"founded_on": null,
"ceased_on": null,
"active": null,
"commercial_registration": {
"location": null,
"registered_on": null
},
"has_workforce": null
},
"headquarter": {
"address_line_1": null,
"address_line_2": null,
"postal_code": null,
"city": null,
"country_code": null
},
"legal_representatives": []
},
"workflow_session_id": null
}When requesting a company verification for a company registered in Germany make sure to send :
- the
company_namein addition to thecompany_numberas it is required to correctly identify the company you are trying to verify.
Removing the legal form such as GmbH from the company name is not necessary.
Type of companies currently handled by our verification service and expected company number formats
We currently support the following companies in our verification service. As each company number is specific to a company register , you’ll find below a list of the current company types we support and the expected company numbers.
| Register | Description | Accepted Company Number format |
|---|---|---|
| Handelregister (Section A) | Sole proprietorships and partnerships (OHG, KG) | HRA 1234 |
| Handelregister (Section B) | Limited liability companies (e.g., GmbH, AG) | HRB 1234 |
| Vereinsregister | Register for associations and clubs. Example: housing or agricultural cooperatives | VR 1234 |
| Genossenschaftsregister | Register for cooperatives | GnR 298 |
| Parterschaftsregister | Register for partnership companies of professionals used by lawyers, doctors, architects, tax advisors, etc | PR 123 |
Formating rules
To ensure an accurate matching, make sure that the company number you are providing doesn’t contain special characters and respects the above definition.
Adding a “ “ or a “-” between the the register form and the number, ie: HRA-123 is accepted and will not yield an error.
Requesting a Company Verification from a company identification file
We currently only support French company identification documents also called KBIS in pdf format.
Payload details can be found in the API reference here.
- You should specify
“country_code”:”FR”when requesting a company verification from a company identification file. - When uploading your company identification file make sure : it's not a password-protected.
Updated 16 days ago