Skip to main content
WEBHOOK

Headers

Idenfy-Event-Type
enum<string>
required
Available options:
AGE_ESTIMATION
Idenfy-Signature
string

Webhook signature

Body

application/json
scanRef
string
required

The step-up scan reference, or the token id when there is no scan ref.

status
enum<string>
required
Available options:
COMPLETED,
FAILED
occurredAt
string<date-time>
required
outcome
enum<string> | null
Available options:
SUCCESS,
UNDERAGE,
UNCERTAIN,
FACE_MISMATCH,
ATTEMPTS_EXCEEDED
verdict
string | null

Model verdict (e.g. ADULT).

estimatedAge
integer | null

The established age. When a document step-up produced an age, that exact document age is reported; otherwise it is the AI face-estimated age.

confidence
number<float> | null
clientId
string | null

Response

200

Return a 200 status to indicate that the data was received successfully.