EndpointsAge verification

Get the status of an age verification request

Returns the current state of an age verification request. Poll it after starting a verification, or use it to confirm a webhook server-side. A request moves from `PENDING` to `IN_PROGRESS` and settles on `PASS` or `FAIL`. A settled request also carries what was established — the age estimate, age category and method used — and, on failure, the reason. Treat anything other than `PASS` or `FAIL` as still in flight.

GET
/age-verification/get-status
AuthorizationBearer <token>

In: header

Query Parameters

id*string

The ID of the age verification request

Match^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$
Formatuuid
includeDob?boolean

Whether to include the verified date of birth (dob) when available. An explicit true or false overrides the product's age result setting. If omitted, the product's setting decides.

Response Body

application/json

curl -X GET "https://example.com/age-verification/get-status?id=ae6d4729-af32-42ea-8ef2-ff46c7664802"

{  "id": "ae6d4729-af32-42ea-8ef2-ff46c7664802",  "status": "PASS",  "age": {    "low": 18,    "high": 20  },  "ageCategory": "adult",  "method": "id-document"}