Submit a session for verification | Verifa

Submit a session for verification processing after uploading all required documents via the API. Validates that required documents are present (id_front, id_back for driver’s licenses, selfie if face_match is in the workflow) and triggers async verification.

For sandbox sessions, returns sandbox_pending status — use the /simulate endpoint to choose an outcome.

Required scope: sessions:write

Submit a session for verification processing after uploading all required documents via the API. Validates that required documents are present (id_front, id_back for driver's licenses, selfie if face_match is in the workflow) and triggers async verification. For sandbox sessions, returns `sandbox_pending` status — use the `/simulate` endpoint to choose an outcome. **Required scope:** `sessions:write`

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

session_idstringRequired

Session ID (ses_*).

Response

Session submitted for verification.

idstring

Public ID of the session.

statusenum

The session's new status after submission.

Allowed values:

is_sandboxboolean

Whether this is a sandbox session.

messagestring

Human-readable status message.

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://devapi.withverifa.com/api/v1/sessions/session_id/submit"
4
5	headers = {"X-API-Key": "<apiKey>"}
6
7	response = requests.post(url, headers=headers)
8
9	print(response.json())

1	{
2	"id": "ses_abc123",
3	"status": "processing",
4	"is_sandbox": true,
5	"message": "string"
6	}

Authentication

Path parameters

Headers

Response

Errors