Age Verification

Age verification endpoints determine available verification methods and initiate age assurance flows.

Age Verification Result Object

The result of initiating an age verification flow.

Age Verification Result Structure
FieldTypeDescription
verification_request_id?stringThe ID of the verification request
verification_webview_url?stringThe URL used to complete web-based verification
verification_vendor_name?stringThe name of the verification vendor
incode_parameters?Incode parameters objectParameters used to complete verification in Incode
Incode Parameters Structure
FieldTypeDescription
api_url?stringThe Incode API URL
session_tokenstringThe Incode session token
consent_idstringThe Incode consent ID
interview_idstringThe Incode interview ID
method?integerThe age verification method

Age Verification Method Object

An age verification method offered to the current user.

Age Verification Method Structure
FieldTypeDescription
methodintegerThe verification method
vendorstringThe verification vendor
titlestringThe localized method title
descriptionstringThe localized method description
provided_by??stringThe localized provider attribution
icon??age verification method icon objectThe icon displayed for the method
Age Verification Method Icon Structure
FieldTypeDescription
pathsarray[age verification method icon path object]The SVG paths composing the icon
Age Verification Method Icon Path Structure
FieldTypeDescription
dstringThe SVG path data
fill_rule?stringThe SVG fill rule, currently only evenodd
Age Verification Method Type
ValueNameDescription
1FACIAL_AGE_ESTIMATIONFacial age estimation
2ID_VERIFICATIONIdentity document verification
3MODULARVendor-selected modular verification
9GOOGLE_WALLETGoogle Wallet age verification
Age Verification Vendor
ValueDescription
K_IDk-ID
GOOGLE_WALLETGoogle Wallet
INCODEIncode

Age Verification Methods Response Object

The available age verification methods.

Age Verification Methods Response Structure
FieldTypeDescription
methodsarray[age verification method object]The available age verification methods
footer_message?stringThe localized footer displayed below the methods
Example Age Verification Methods Response
{
"methods": [
{
"method": 1,
"vendor": "INCODE",
"title": "Estimate your age",
"description": "Use a video selfie to estimate your age.",
"provided_by": "Provided by Incode",
"icon": {
"paths": [
{
"d": "M12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20Z",
"fill_rule": "evenodd"
}
]
}
}
],
"footer_message": null
}

Reactive Check Object

The result of the current user's reactive age verification check.

Reactive Check Structure
FieldTypeDescription
statusstringThe reactive check status
Reactive Check Status
ValueDescription
missThe check did not find a reason to require verification
passedThe check completed successfully

Endpoints

Test Age Assurance

POST/age-verification/test

Initiates a test age assurance flow. Returns an age verification result object on success.

JSON Params
FieldTypeDescription
methodintegerThe age verification method

Verify Age

POST/age-verification/verify

Initiates age verification with the selected method and vendor. Returns an age verification result object on success.

JSON Params
FieldTypeDescription
methodintegerThe age verification method
vendorstringThe age verification vendor

Verify Age v2

POST/age-verification/verify/v2

Initiates the second version of age verification with the selected method and vendor. Returns an age verification result object on success.

JSON Params
FieldTypeDescription
methodintegerThe age verification method
vendorstringThe age verification vendor

Register Incode Interview

POST/age-verification/incode/interview

Registers a completed Incode interview. Returns a 204 empty response on success.

JSON Params
FieldTypeDescription
interview_idstringThe Incode interview ID

Create Incode Session

POST/age-verification/incode/session

Creates an Incode age verification session. Returns an age verification result object on success.

JSON Params
FieldTypeDescription
previous_interview_id?stringThe ID of the previous Incode interview to retry

List Age Verification Methods

GET/age-verification/methods

Returns the available age verification method types.

Response Body
FieldTypeDescription
methodsarray[integer]The available age verification methods

List Age Verification Methods v2

GET/age-verification/methods/v2

Returns an age verification methods response object.

Get Age Verification Reactive Check

GET/users/@me/age-verification/check

Returns a reactive check object.

Reset Age Verification

POST/users/@me/age-verification/reset

Clears the current user's pending age verification state. Returns a 204 empty response on success.

List Suspended User Age Verification Methods

POST/age-verification/suspended/methods

Returns the age verification methods available to a suspended user.

JSON Params
FieldTypeDescription
tokenstringThe suspended user token
Response Body
FieldTypeDescription
methodsarray[integer]The available age verification methods