Submits an identity verification request. In live mode, all
verification checks are performed automatically and a decision is
returned synchronously.
In sandbox mode, no checks are performed and the response always
returns approved with a simulated face match score of 99.90.
No balance is deducted in sandbox mode.
Document Requirements (live mode)
The idImage URL must point to a clear, well-lit, unobstructed photo
of a valid government-issued identity document. The document must:
Be a valid, non-expired passport, national identity card, or
driver license.
Contain a visible photo of the document holder (for biometric comparison).
Be unmodified — no digital editing, screenshots, or photocopies.
Minimum resolution of 200x150 pixels.
Selfie Requirements (live mode)
The userPhoto URL must point to a clear selfie of the person.
The selfie must show a single face, eyes open, no sunglasses, and
be well-lit with the face clearly visible and not partially covered.
Supported Country Codes
The countryCode field accepts ISO 3166-1 alpha-2 codes for supported
countries only. Unsupported codes return HTTP 422. Sanctioned
jurisdictions (Cuba, Iran, North Korea, Syria, Crimea, Donetsk, Luhansk)
return a rejected outcome.
ID Type Matching
The idType submitted must match the actual document type detected
on the idImage. Submitting passport while providing a national ID
card results in a rejected outcome.
IP Restriction
In live mode, requests must originate from a whitelisted IP address.
sandbox mode has no IP restriction.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
