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:

CountryFormatDescriptionExample
France (FR)SIREN9-digit number issued by INSEE794513986
Belgium (BE)Enterprise Number10-digit number from the Crossroads Bank for Enterprises0223.459.690
Switzerland (CH)UID9-digit business ID from the Federal Statistical Office396.664.102
United Kingdom (GB)CRN (Company Registration Number)8-digit number, or 2 letters followed by 6 digits, issued by Companies HouseRC000057
Netherlands (NL)KVK8-digit number issued by Kamer van Koophandel17001910

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_name in addition to the company_number as 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.

RegisterDescriptionAccepted 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
VereinsregisterRegister for associations and clubs. Example: housing or agricultural cooperativesVR 1234
GenossenschaftsregisterRegister for cooperativesGnR 298
ParterschaftsregisterRegister for partnership companies of professionals used by lawyers, doctors, architects, tax advisors, etcPR 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.