---
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`.
  - `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.dev/synctera/apis/synctera-api.md) · [All operations](https://skmtc.dev/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synctera/synctera-api/revisions/a6363e3dbb7b/schema)