📘
In some cases, you may not be able to retrieve all company-related data during the verification process. This typically occurs when the sole proprietor has explicitly requested to restrict the public dissemination of their personal information in the SIREN register for example.

Get company verification results via Webhooks

Webhooks provide an efficient way to get notified when a company verification has been completed, and to retrieve the related verification results.
For more details on setting up and managing Webhooks, please refer to this dedicated section.

To receive those notifications, subscribe to the following event:

Event	Description
`verification.company.done`	Triggered when a company verification is complete

Example Webhook Payload for a verified company verification:

{
  "id": "21417328-7a20-4715-800d-350cad8d2bd1",
  "workspace_id": "090b4f7e-25e8-423d-9387-741f6188ba7a",
  "created_at": "2025-03-24T13:32:26+00:00",
  "updated_at": "2025-03-24T13:32:46+00:00",
  "status": "verified",
  "data_anonymized": false,
  "data": {
    "company": {
      "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:26:31+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
          }
        ]
      }
    }
  }
}

For more information on the statuses, please refer to this section.

Retrieve detailed company verification results

You can also obtain detailed verification results by calling a dedicated endpoint, with the id returned when requesting a company verification:

GET /verifications/companies/{id}

{
    "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:31+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
            }
        ]
    }
}

Similar to the webhook, you will receive the verification status. For more information on the statuses, please refer to this section.

ℹ️ After 7 days, Company Verification records are anonymized, meaning all personal or sensitive data associated with the verification request is permanently deleted. If you need to reaccess this information, you’ll need to initiate a new verification request.

List all company verification requests

To retrieve a list of all verification requests, you can call the following endpoint. You can filter by status, workspace_id or paginate the results based on your needs:

GET /verifications/companies

{
  "meta": {
    "next_cursor": "string"
  },
  "data": [
    {
      "id": "89120884-d29a-4b1a-ac7b-a9e73a872795",
      "status": "pending",
      "status_codes": [],
      "created_at": "2025-01-21T15:59:19+00:00",
      "updated_at": "2025-01-21T15:59:21+00:00"
    }
  ]
}

Follow company verification status

ℹ️
Unlike the verified status, a failed verification does not incur a charge to the client.

The company verification lifecycle is really simple and consists of the following stages:

Status	Description
pending	The verification has been initiated.
verified	The company was successfully identified. Official data is returned.
failed	The company doesn't exist as no match was found for the provided company number and country,