Passer au contenu principal
POST
Upload from the browser with the client token

Autorisations

Authorization
string
header
requis

vn_ct_… from POST /v1/sessions.

Paramètres de chemin

id
string
requis

Corps

front
file
requis

Document front (passport data page). JPEG, PNG or WebP, up to 12 MB.

back
file

CNI back. Omit for a passport.

selfie
file

Live photo of the holder. Omit to skip the face check.

chip
string

Optional. The chip object of the JSON body, as a JSON string.

liveness
string

Optional. The liveness object of the JSON body, as a JSON string.

metadata
string

Optional. The metadata object of the JSON body, as a JSON string. Ignored on a session upload: the session’s own applies.

Réponse

Verdict

Five checks, each with bilingual evidence. final_verdict appears on reads once a reviewer decided.

id
string
requis
Pattern: ^vrf_[a-z0-9]{6,}$
verdict
enum<string>
requis

The published verdict: the workflow’s when one ran (it can only be stricter than the checks’), else the checks’.

Options disponibles:
verified,
review,
rejected
score
number
requis
Plage requise: 0 <= x <= 1
document_type
enum<string>
requis
Options disponibles:
passport,
cni,
unknown
checks
object[]
requis
latency_ms
integer
requis
Plage requise: 0 <= x <= 9007199254740991
created_at
string<date-time>
requis
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
status
enum<string>
Options disponibles:
VERIFIED,
REVIEW,
REJECTED
document
object
fields
object | null
face_match
object | null
rules_verdict
enum<string> | null

The checks’ verdict, only when a workflow made verdict stricter; null otherwise.

Options disponibles:
verified,
review,
rejected
workflow
object | null

The application’s workflow that ran on this verification (Grands comptes plan): version (null for the test draft), run_id, decided (it changed the verdict), reason, team, status (running while sends are queued, completed, or error: the checks’ verdict stands). Null when none ran.

metadata
object | null

What you attached to the session or the request; null when nothing.

timings
object