Request a Company Verification

Suggest Edits

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
}

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	8-digit number, or 2 letters followed by 6 digits, issued by Companies House	RC000057

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.

Updated 1 day ago