Sign in

v1

latestOpenAPI 3.0.0proprietary2026-07-261695971.5 MB
Company Verification

Initiate a new Company Verification

Initiate a new Company Verification by providing the company number or by uploading a document containing company information.

Related guide: Company Registry Verification.

ℹ️ This endpoint accepts two request body formats — pick the one that matches your use case:

  • 📝 application/json — provide the company number directly, or reference an existing Workflow Session Applicant by ID.
  • 📁 multipart/form-data — upload a binary file containing the company information.

🔓 Endpoint access

  • Environments: production, sandbox
  • API key scopes: organization, workspace
  • Plans: pro, scale
  • Add-ons (for production access): Verify - Company registry verification
post/verifications/companies

Request body

OR

Example request

{
  "company_number": "794513986",
  "country_code": "FR",
  "workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
  "workflow_session_id": "0ef334d2-7f36-4643-8a2a-4283b4a3e4a4",
  "previous_attempt_id": "9412b83b-b4b9-4a94-97b5-2b43dfa4cde4",
  "company_name": "Test Company GmbH",
  "zip_code": "10115",
  "street": "Unter den Linden 1",
  "city": "Berlin",
  "register_court": "Amtsgericht Berlin (Charlottenburg)"
}

Response

Created

idstring uuid required

The unique identifier for a resource.

workspace_idstring uuid required

The Workspace ID in which the verification has been created.

created_atstring date-time required

Creation date of the Company Verification.

updated_atstring date-time required

Update date of the Company Verification.

status'pending' | 'awaiting_data' | 'verified' | 'failed' | 'inconclusive' required

Status of the Company Verification.

data_anonymizedboolean

Indicates if the company data has been anonymized. If set to true, all fields in the data field are set to NULL.

workflow_session_idstring uuid nullable required

Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.

previous_attempt_idstring uuid nullable required

ID of the previous attempt within the same workflow_session_id. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.

applicant_idstring uuid nullable required

Unique identifier of an Applicant.

Example response

{
  "id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
  "workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:00:00Z",
  "status": "verified",
  "workflow_session_id": "0ef334d2-7f36-4643-8a2a-4283b4a3e4a4",
  "previous_attempt_id": "9412b83b-b4b9-4a94-97b5-2b43dfa4cde4",
  "applicant_id": "0ef334d2-7f36-4643-8a2a-4283b4a3e4a4",
  "data": {
    "company_information": {
      "name": "YOUTRUST",
      "company_number": "794513986",
      "partial_data": true,
      "required_document_type": [
        "company_certificate"
      ],
      "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"
        }
      ],
      "founded_on": "2013-07-24",
      "commercial_registration": {
        "location": "CAEN",
        "registered_on": "2013-08-01"
      }
    },
    "headquarter": {
      "address_line_1": "AVENUE PIERRE BERTHELOT",
      "postal_code": "14000",
      "city": "CAEN",
      "country_code": "FR"
    },
    "legal_representatives": [
      {
        "title": "Président",
        "first_name": "John",
        "last_name": "Doe",
        "birth_name": "Doe",
        "born_on": "1994-04-20"
      }
    ]
  }
}