Request a company verification

🚧
Under redesign
The company verification feature is currently undergoing a redesign to bring more consistency and simplicity to our verification products.
During this refactoring phase, the technical architecture may change (e.g., updated endpoints or new response payloads, etc...).
If you plan to integrate it soon, please contact us first so we can guide you accordingly.

To initiate the company verification process, you need to send the company identification number, using the following endpoint:

POST /verifications/companies

{
    "company_number": "794513986",
    "country_code": "FR",
    "workspace_id": null
}

📘
The Company Verification feature is currently fully available in production for France.
For the following countries, data availability may vary as they are still in Beta:

Belgium

Switzerland

United Kingdom

Netherlands

We encourage you to share any feedback or issues encountered when using the service in these countries.

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

After submitting your request, the API responds immediately depending on the data availability with the verification result and company data. For more details, please refer to the endpoint.

{
    "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": "verified",
    "data": {
        "company_information": {
            "name": "YOUSIGN",
            "trade_name": null,
            "company_number": "794513986",
            "legal_form": {
                "code": "6CHY",
                "description": "SAS, société par actions simplifiée"
            },
            "vat_number": "FR61794513986",
            "activities": [
                {
                    "code": "62.01",
                    "description": "Computer programming activities",
                    "classification": "NACE"
                },
                {
                    "code": "62.01Z",
                    "description": "Programmation informatique",
                    "classification": "NAFRev2"
                }
            ],
            "founded_on": "2013-07-24",
            "ceased_on": null,
            "active": true,
            "commercial_registration": {
                "location": "CAEN",
                "registered_on": "2013-08-01"
            },
            "has_workforce": true
        },
        "headquarter": {
            "address_line_1": "AVENUE PIERRE BERTHELOT",
            "address_line_2": "RUE DE SUEDE",
            "postal_code": "14000",
            "city": "CAEN",
            "country_code": "FR"
        },
        "legal_representatives": [
            {
                "title": "Président",
                "type": "natural_person",
                "first_name": "John",
                "last_name": "Doe",
                "born_on": "1990-07-14",
                "company_name": null,
                "company_number": null
            }
        ]
    }
}

Here’s how to interpret the different statuses returned in the API response:

Status	Description
verified	The company was successfully identified. Official data is returned.
failed	No match was found for the provided company number and country.

ℹ️ Please note that the data is not stored, so a new verification will be required each time this information is needed.

🚧Under redesign

📘

🚧
Under redesign