Skip to main content
POST
Create verification

Authorizations

Authorization
string
header
required

API key as Bearer token

Body

document_front
string<byte>
required

Base64 encoded front of document

document_type
enum<string>
required
Available options:
cin,
cni,
passport,
permit,
residence_card
country
string
required
Pattern: ^[A-Z]{2}$
Example:

"MA"

document_back
string<byte>

Base64 encoded back of document

selfie
string<byte>

Base64 encoded selfie image

checks
enum<string>[]
Available options:
ocr,
face_match,
liveness,
fraud,
duplicate
mode
enum<string>
default:sync
Available options:
sync,
async
webhook_url
string<uri>

Webhook URL for async results

metadata
object

Custom metadata

Response

Verification completed (sync mode)

id
string
Example:

"ver_a1b2c3d4e5f6"

object
enum<string>
Available options:
identity.verification
created_at
string<date-time>
updated_at
string<date-time>
status
enum<string>
Available options:
pending,
verified,
rejected,
review,
expired,
error
document_type
string
country
string
extracted_data
object
checks
object
risk_score
integer
Required range: 0 <= x <= 1000
risk_level
enum<string>
Available options:
low,
medium,
high,
critical
fraud_signals
object[]
metadata
object