Skip to main content

Start a new Age Verification session

POST 
/age-verification/start

Start a New Age Verification Session​

This endpoint starts a new Age Verification (Age Estimation) session and returns a session ID.
The session is used to perform age estimation, with an optional liveness check, during a subsequent verification process.

No verification is performed at this stage. This endpoint only initializes the session.

Request Body Details​

Optional parameters include:

  • customerId: Associate the session with an internal customer or user record.
    This value is returned with the verification results for easier correlation.
  • withLiveness: Indicates whether the session should also perform a liveness check.

Session Behavior​

  • A unique session ID is generated and returned upon successful initialization.
  • The session ID is required to start the age verification process.
  • Credits are not deducted when starting the session.
    Credits are deducted only after the session is processed.

Additional Information​

  • The age estimation is derived from a face capture performed later in the session lifecycle.
  • If enabled, liveness verification is executed as part of the same session.
  • Results are delivered after the session is completed and are not stored on Authenticalls systems.

Request​

Responses​