---
title: "Initiate Document Verification Session"
method: POST
path: "/verifications/docv_session"
tags: ["KYC/KYB Verifications"]
---

# Initiate Document Verification Session

`POST /verifications/docv_session`

Initiate document verification session to be used with `/verifications/verify`.

## Headers

- `Idempotency-Key` string

## Request body

- DocumentVerificationSessionRequest
  - `document_type` 'LICENSE' | 'PASSPORT' — If provided, the document_type is used to constrain the type of document that can be collected from the end-customer.
  - `language` 'AR' | 'AR-SA' | 'BN' | 'CS-CZ' | 'DA-DK' | 'DE-DE' | 'EN' | 'EN-AU' | 'EN-CA' | 'EN-GB' | 'EN-US' | 'ES' | 'ES-001' | 'ES-AR' | 'ES-ES' | 'ES-MX' | 'ES-US' | 'FI-FI' | 'FR' | 'FR-CA' | 'HE-IL' | 'HI-IN' | 'HT' | 'HU-HU' | 'HY' | 'ID-ID' | 'IT' | 'IT-CH' | 'JA-JP' | 'KO' | 'MS-MY' | 'NL-NL' | 'NO-NO' | 'PL-PL' | 'PT-BR' | 'PT-PT' | 'RO-MO' | 'RO-RO' | 'RU' | 'SK-SK' | 'SV-SE' | 'TH-TH' | 'TL' | 'TR-TR' | 'UR' | 'VI' | 'ZH-CN' | 'ZH-HK' | 'ZH-TW' — The language to be used in the document verification session. If not provided, defaults to `EN-US`. One of the following: * `AR` – Arabic * `AR-SA` – Arabic (Saudi Arabia) * `BN` – Bengali * `CS-CZ` – Czech (Czech Republic) * `DA-DK` – Danish (Denmark) * `DE-DE` – German (Germany) * `EN` – English * `EN-AU` – English (Australia) * `EN-CA` – English (Canada) * `EN-GB` – English (United Kingdom) * `EN-US` – English (United States) * `ES` – Spanish * `ES-001` – Spanish (World) * `ES-AR` – Spanish (Argentina) * `ES-ES` – Spanish (Spain) * `ES-MX` – Spanish (Mexico) * `ES-US` – Spanish (United States) * `FI-FI` – Finnish (Finland) * `FR` – French * `FR-CA` – French (Canada) * `HE-IL` – Hebrew (Israel) * `HI-IN` – Hindi (India) * `HT` – Haitian Creole * `HU-HU` – Hungarian (Hungary) * `HY` – Armenian * `ID-ID` – Indonesian (Indonesia) * `IT` – Italian * `IT-CH` – Italian (Switzerland) * `JA-JP` – Japanese (Japan) * `KO` – Korean * `MS-MY` – Malay (Malaysia) * `NL-NL` – Dutch (Netherlands) * `NO-NO` – Norwegian (Norway) * `PL-PL` – Polish (Poland) * `PT-BR` – Portuguese (Brazil) * `PT-PT` – Portuguese (Portugal) * `RO-MO` – Romanian (Moldova) * `RO-RO` – Romanian (Romania) * `RU` – Russian * `SK-SK` – Slovak (Slovakia) * `SV-SE` – Swedish (Sweden) * `TH-TH` – Thai (Thailand) * `TL` – Tagalog * `TR-TR` – Turkish (Turkey) * `UR` – Urdu * `VI` – Vietnamese * `ZH-CN` – Chinese (Simplified, China) * `ZH-HK` – Chinese (Traditional, Hong Kong) * `ZH-TW` – Chinese (Traditional, Taiwan)
  - `person_id` string, uuid, required — Unique ID for the person. Exactly one of `person_id` or `business_id` must be set.
  - `send_message` boolean — Send an SMS containing the document verification link to the end-customer using the phone number provided on the customer record.

## Response `201`

Created document verification session token.

- DocumentVerificationSessionResponse
  - `id` string, uuid — Unique ID for this document verification session.
  - `person_id` string, uuid, required — Unique ID for the person. Exactly one of `person_id` or `business_id` must be set.
  - `session_token` string, required — ID of the document verification session to be used in `/verifications/verify` request.
  - `status` 'COMPLETE' | 'PENDING', required — The current state of the document verification session. One of the following: * `PENDING` – the session is pending verification. * `COMPLETE` – the end-customer has submitted the requested documents.
  - `url` string, required — URL of the document verification session which can be shared with the end-customer.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `404` — Resource not found
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/versions/b0d812e6cdd0/schema)