---
title: "Submit Document Verification"
method: POST
path: "/v3/document_verification"
tags: ["Document Verification"]
---

# Submit Document Verification

`POST /v3/document_verification`

Verifies a user's identity by comparing a selfie against a document image. The selfie and liveness images are uploaded alongside a document photo (front, and optionally back). The id_type is optional — the document type is auto-classified if not provided. Results are delivered asynchronously via callback URL.

## Headers

- `SmileID-Partner-ID` string, required
- `SmileID-Source-SDK` string
- `SmileID-Source-SDK-Version` string
- `SmileID-Timestamp` string, date-time
- `SmileID-Request-Signature` string
- `User-ID` string

## Response `202`

Accepted — job submitted for processing.

- AcceptedResponse
  - `status` 'accepted', required — Acceptance status for queued verification requests.
  - `message` string, required — Human-readable acceptance message.
  - `job_id` string, required — TypeID format verification identifier for tracking.
  - `user_id` string, required — TypeID format user identifier, or partner-provided user identifier.
  - `created_at` string, date-time, required — ISO 8601 timestamp of when the verification was created.

## Other responses

- `400` — Bad Request — validation error in request body or headers.
- `401` — Unauthorized — invalid or missing authentication credentials.
- `402` — Payment Required — insufficient wallet balance.
- `403` — Forbidden — partner not authorized for this product or IP.
- `413` — Content Too Large — an uploaded file exceeds the size limit.
- `415` — Unsupported Media Type — request must be multipart/form-data.
- `429` — Too Many Requests — rate limit exceeded.
- `500` — Internal Server Error

---

[API](https://skmtc.net/smileidentity/apis/v3-authentication-token-api.md) · [All operations](https://skmtc.net/smileidentity/apis/v3-authentication-token-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smileidentity/v3-authentication-token-api/revisions/9f178647f9b8/schema)