nonce	string	An UUID V4 value generated by the Yoti SDK Request Builder
timestamp	string	Current UNIX Timestamp
secure	boolean	Run a secure request that was built with the React Face Capture: https://www.npmjs.com/package/@getyoti/react-face-capture
multiframe	boolean	Use the multiframe mode for a secure request. See the 'secure' argument for more information.

Request Body

object	object
img	string	Base64 encoded image.
metadata	object
device	string	(optional) Device used to send the request (unknown \| laptop \| mobile \| any).
level_of_assurance	string	(optional) The level of assurance to apply for the model score threshold.
secure	object	Secure information that certifies the image was not modified. The Yoti React Face Capture provides this information that shouldn't be edited.
version	string	The version of the secure module used to capture the image.
token	string	The token used to verify the session used to capture the image.
signature	string	Data used to verify that the payload hasn't been modified after the capture.
verification	string	Encrypted data used to perform secure payload validation. This field is available from version SICAP 1.3.0.

POST /ai/v1/antispoofing

 
curl --request POST \ --url 'https://age.yoti.com/ai/v1/antispoofing' \ --header 'X-Yoti-Auth-Digest: {X-Yoti-Auth-Digest}' \ --data nonce=def6fd14-dba9-4610-b6c3-9a7e8909aac0 \ --data timestamp=2026-05-02T11:53:33Z \ --data secure=true \ --data multiframe={multiframe} \ --data '{  "img": "c2FtcGxlIGltYWdlIGRhdGE=",  "metadata": {    "device": "mobile"  },  "level_of_assurance": "medium",  "secure": {    "version": "1.0.0",    "token": "<JWT token>",    "signature": "<hmac sha512>",    "verification": "<encrypted data>"  }}'
Copy

Responses

200

A prediction was made

prediction string

400

Image validation error or malformed request

401

Unauthorized

403

Forbidden

404

Resource not found

413

Payload too large

500

Internal server error

503

Service temporarily unavailable

Response

 
{ "prediction": "real | fake"}
Copy

Liveness and age estimation check

Auth

Query String

nonce	string	An UUID V4 value generated by the Yoti SDK Request Builder
timestamp	string	Current UNIX Timestamp
secure	boolean	Run a secure request that was built with the React Face Capture: https://www.npmjs.com/package/@getyoti/react-face-capture
multiframe	boolean	Use the multiframe mode for a secure request. See the 'secure' argument for more information.

Request Body

object	object
img	string	Base64 encoded image.
metadata	object
device	string	(optional) Device used to send the request (unknown \| laptop \| mobile \| any).
level_of_assurance	string	(optional) The level of assurance to apply for the model score threshold.
secure	object	Secure information that certifies the image was not modified. The Yoti React Face Capture provides this information that shouldn't be edited.
version	string	The version of the secure module used to capture the image.
token	string	The token used to verify the session used to capture the image.
signature	string	Data used to verify that the payload hasn't been modified after the capture.
verification	string	Encrypted data used to perform secure payload validation. This field is available from version SICAP 1.3.0.

POST /ai/v1/age-antispoofing

 
curl --request POST \ --url 'https://age.yoti.com/ai/v1/age-antispoofing' \ --header 'X-Yoti-Auth-Digest: {X-Yoti-Auth-Digest}' \ --data nonce=def6fd14-dba9-4610-b6c3-9a7e8909aac0 \ --data timestamp=2026-05-02T11:53:33Z \ --data secure=true \ --data multiframe={multiframe} \ --data '{  "img": "c2FtcGxlIGltYWdlIGRhdGE=",  "metadata": {    "device": "mobile"  },  "level_of_assurance": "medium",  "secure": {    "version": "1.0.0",    "token": "<JWT token>",    "signature": "<hmac sha512>",    "verification": "<encrypted data>"  }}'
Copy

Responses

200

A prediction was made

object	object
antispoofing	object
prediction	string
age	object
age	number
std_dev	number

400

Image validation error or malformed request

401

Unauthorized

403

Forbidden

404

Resource not found

413

Payload too large

500

Internal server error

503

Service temporarily unavailable

Response

 
{ "antispoofing": {  "prediction": "real | fake" }, "age": {  "age": 25.1,  "std_dev": 3.5 }}
Copy

Age estimation check

Auth

Query String

nonce	string	An UUID V4 value generated by the Yoti SDK Request Builder
timestamp	string	Current UNIX Timestamp
secure	boolean	Run a secure request that was built with the React Face Capture: https://www.npmjs.com/package/@getyoti/react-face-capture
multiframe	boolean	Use the multiframe mode for a secure request. See the 'secure' argument for more information.

Request Body

object	object
img	string	Base64 encoded image.
metadata	object
device	string	(optional) Device used to send the request (unknown \| laptop \| mobile \| any).
level_of_assurance	string	(optional) The level of assurance to apply for the model score threshold.
img_validation_level	string	(optional) The level of validations to be applied against the image and bounding boxes.
secure	object	Secure information that certifies the image was not modified. The Yoti React Face Capture provides this information that shouldn't be edited.
version	string	The version of the secure module used to capture the image.
token	string	The token used to verify the session used to capture the image.
signature	string	Data used to verify that the payload hasn't been modified after the capture.
verification	string	Encrypted data used to perform secure payload validation. This field is available from version SICAP 1.3.0.

POST /ai/v1/age

 
curl --request POST \ --url 'https://age.yoti.com/ai/v1/age' \ --header 'X-Yoti-Auth-Digest: {X-Yoti-Auth-Digest}' \ --data nonce=def6fd14-dba9-4610-b6c3-9a7e8909aac0 \ --data timestamp=2026-05-02T11:53:33Z \ --data secure=true \ --data multiframe={multiframe} \ --data '{  "img": "c2FtcGxlIGltYWdlIGRhdGE=",  "metadata": {    "device": "mobile"  },  "level_of_assurance": "medium",  "img_validation_level": "high",  "secure": {    "version": "1.0.0",    "token": "<JWT token>",    "signature": "<hmac sha512>",    "verification": "<encrypted data>"  }}'
Copy

Responses

200

A prediction was made

object	object
age	number
std_dev	number

400

Image validation error or malformed request

401

Unauthorized

403

Forbidden

404

Resource not found

413

Payload too large

500

Internal server error

503

Service temporarily unavailable

Response

 
{ "age": 25.1, "std_dev": 3.5}
Copy

Liveness and age estimation check (self-checkout)

Auth

Headers

Terminal-ID	string	Integrator terminal ID
Session-ID	string	Session ID created by Yoti server

Query String

nonce	string	An UUID V4 value generated by the Yoti SDK Request Builder
timestamp	string	Current UNIX Timestamp
secure	boolean	Run a secure request that was built with the React Face Capture: https://www.npmjs.com/package/@getyoti/react-face-capture
multiframe	boolean	Use the multiframe mode for a secure request. See the 'secure' argument for more information.

Request Body

object	object
img	string	Base64 encoded image.
metadata	object
device	string	(optional) Device used to send the request (unknown \| laptop \| mobile \| any).
secure	object	(optional) Secure information that certifies the image was not modified. The Yoti React Face Capture provides this information that shouldn't be edited.
version	string	The version of the secure module used to capture the image.
token	string	The token used to verify the session used to capture the image.
signature	string	Data used to verify that the payload hasn't been modified after the capture.
verification	string	Encrypted data used to perform secure payload validation. This field is available from version SICAP 1.3.0.

POST /ai/v1/self-checkout/age-antispoofing

 
curl --request POST \ --url 'https://age.yoti.com/ai/v1/self-checkout/age-antispoofing' \ --header 'Terminal-ID: {Terminal-ID}' \ --header 'Session-ID: {Session-ID}' \ --header 'X-Yoti-Auth-Digest: {X-Yoti-Auth-Digest}' \ --data nonce=def6fd14-dba9-4610-b6c3-9a7e8909aac0 \ --data timestamp=2026-05-02T11:53:33Z \ --data secure=true \ --data multiframe={multiframe} \ --data '{  "img": "c2FtcGxlIGltYWdlIGRhdGE=",  "metadata": {    "device": "mobile"  },  "secure": {    "version": "1.0.0",    "token": "<JWT token>",    "signature": "<hmac sha512>",    "verification": "<encrypted data>"  }}'
Copy

Responses

200

A prediction was made

prediction string

400

Image validation error or malformed request

401

Unauthorized

403

Forbidden

404

Resource not found

413

Payload too large

500

Internal server error

503

Service temporarily unavailable

Response

 
{ "antispoofing": {  "prediction": "real | fake" }, "age": {  "age": 25.1,  "std_dev": 3.5 }}
Copy