---
title: "Initiate a new Company Verification"
method: POST
path: "/verifications/companies"
tags: ["Company Verification"]
---

# Initiate a new Company Verification

`POST /verifications/companies`

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

Related guide: [Company Registry Verification](https://developers.youtrust.com/docs/company-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`

## Request body

- union
  - InitiateCompanyFromJson
    - `company_number` string, required — Please provide the exact company number depending on the country format. For any doubt, consult the Company Verification [guide](https://developers.youtrust.com/docs/company-verification).
    - `country_code` 'FR' | 'GB' | 'BE' | 'CH' | 'NL' | 'ES' | 'LU' | 'IT' | 'DE', required — Defines the country where the company is registered.
    - `workspace_id` string, uuid, nullable — Scopes the verification to a specific workspace. Defaults to the default workspace if not specified.
    - `workflow_session_id` string, uuid, nullable — 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_id` string, uuid, nullable — 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.
    - `company_name` string, safe-string, nullable — The company name. Required for German (DE) companies.\ When country_code is DE, this field must be provided.\ This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).
    - `zip_code` string, safe-string, nullable — Additional search field. Only accepted when country_code is DE.\ For DE, it must be a 5-digit Postleitzahl (e.g. "10115").\ Helps narrow the company lookup when several companies share similar names.\ This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).
    - `street` string, safe-string, nullable — Additional search field. Only accepted when country_code is DE.\ Helps narrow the company lookup when several companies share similar names.\ This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).
    - `city` string, safe-string, nullable — Additional search field. Only accepted when country_code is DE.\ Helps narrow the company lookup when several companies share similar names.\ This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).
    - `register_court` string, safe-string, nullable — Additional search field. Only accepted when country_code is DE.\ The German commercial register court (Registergericht) handling the company.\ This property is a [Safe String](https://developers.youtrust.com/reference/oas-specification#safe-string).
  - InitiateCompanyFromApplicant
    - `applicant_id` string, uuid, required — The Applicant ID linked to the Workflow Session.

## Response `201`

Created

- CompanyFull
  - `id` string, uuid, required — The unique identifier for a resource.
  - `workspace_id` string, uuid, required — The Workspace ID in which the verification has been created.
  - `created_at` string, date-time, required — Creation date of the Company Verification.
  - `updated_at` string, date-time, required — Update date of the Company Verification.
  - `status` 'pending' | 'awaiting_data' | 'verified' | 'failed' | 'inconclusive', required — Status of the Company Verification.
  - `data_anonymized` boolean — Indicates if the company data has been anonymized. If set to `true`, all fields in the `data` field are set to NULL.
  - `workflow_session_id` string, 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_id` string, 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_id` string, uuid, nullable, required — Unique identifier of an Applicant.
  - `data` CompanyFullAllOfData, required
    - `extracted_from_document` CompanyFullAllOfDataExtractedFromDocument
      - `company_number` string, nullable — Company number extracted from the document.
      - `issued_on` string, date, nullable — Date when the document was issued.
    - `company_information` CompanyFullAllOfDataCompanyInformation
      - `name` string, nullable — Denomination of the company.
      - `trade_name` string, nullable — Trade name of the company.
      - `company_number` string, nullable — The number of the company entity.
      - `partial_data` boolean, nullable — Describes if a company has declined to make some of her data public (ie : legal representatives personal data), when true data might be missing from the response
      - `required_document_type` string[] — Provides the right document type to request for a given company based on its registry. ie: company_certificate, rne_certificate or business_registration_certificate. You can use those types when calling Document Analysis.
      - `legal_form` CompanyFullAllOfDataCompanyInformationLegalForm
        - `code` string, nullable, required — Legal form code (ISO 20275).
        - `description` string, nullable, required — Local legal form name.
      - `vat_number` string, nullable — Tax number of the company.
      - `activities` CompanyFullAllOfDataCompanyInformationActivities[]
        - `code` string, nullable, required — Activity code.
        - `description` string, nullable, required — Activity name.
        - `classification` string, nullable, required — Activity classification.
      - `founded_on` string, date, nullable — Company's creation date.
      - `ceased_on` string, date, nullable — Indicates the company's cessation date if company is inactive, otherwise null.
      - `active` boolean, nullable — Indicates whether or not the company is still active.
      - `commercial_registration` CompanyFullAllOfDataCompanyInformationCommercialRegistration
        - `location` string, nullable, required — Indicates the location of the company's commercial register.
        - `registered_on` string, date, nullable, required — Indicates the company's registration date in the commercial register.
      - `has_workforce` boolean, nullable — True if the company has at least one employee.
    - `headquarter` CompanyFullAllOfDataHeadquarter
      - `address_line_1` string, nullable, required
      - `address_line_2` string, nullable, required
      - `postal_code` string, nullable, required
      - `city` string, nullable, required
      - `country_code` string, nullable, required
    - `legal_representatives` CompanyFullAllOfDataLegalRepresentatives[]
      - `title` string, nullable, required — The representative's role within the company.
      - `type` 'natural_person' | 'legal_person', nullable, required — Indicates whether the representative is a natural person or a legal entity.
      - `first_name` string, nullable, required — The representative's first name in case of a natural person, otherwise null.
      - `last_name` string, nullable, required — The representative's last name in case of a natural person, otherwise null.
      - `birth_name` string, nullable, required — The representative's birth name in case of a natural person, otherwise null.
      - `born_on` string, date, nullable, required — The representative's birthdate in case of a natural person, otherwise null.
      - `company_name` string, nullable, required — The representative's company name in case of a legal person, otherwise null.
      - `company_number` string, nullable, required — The representative's company number in case of a legal person, otherwise null.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `415` — UnsupportedMediaType
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)