---
title: "Retrieve a Company Verification"
method: GET
path: "/verifications/companies/{companyVerificationId}"
tags: ["Company Verification"]
---

# Retrieve a Company Verification

`GET /verifications/companies/{companyVerificationId}`

Get the detailed results of a Company Verification.

## Path parameters

- `companyVerificationId` string, uuid, required — The unique identifier for a resource.

## Response `200`

OK

- 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
- `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/versions/8d258c0b45d6/schema)