📘
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.
Ifpartial_data : true then the company has explicitly requested to restrict the public dissemination of their personal information.

Get Company Registry Verification results via Webhooks

Webhooks provide an efficient way to get notified when a Company Registry 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 registry verification is complete

Example Webhook Payload for a verified company registry 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": {
  	"extracted_from_document": {
			"company_number":null,
			"issued_on":null
  	 }, 
    "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",
          "partial_data" : false,
          "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.

Example Webhook Payload for a Company Registry Verification requested via a company identification document.

{
  "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": {
  	"extracted_from_document": {
			"company_number":794513986,
			"issued_on":"2025-06-11"
  	 }, 
    "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",
          "partial_data" : false,
          "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
          }
        ]
      }
    }
  }
}

Retrieve detailed Company Registry Verification results

You can also obtain detailed verification results by calling a dedicated endpoint, with the id returned when requesting a Company Registry 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": {
        "extracted_from_document": {
           "company_number":null,
           "issued_on":null
         }, 
        "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",
            "partial_data" : null, 
            "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 Registry 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 Registry 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 Registry Verification status

ℹ️
Unlike the verified status, a failedor inconclusive 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
inconclusive	The Company Registry Verification was unsuccessful because the company identification number could not be found on the document. A failure to extract the issued_on date won’t induce an inconclusive status.