Retrieve Tokens

Dashboard (Admin) only. These endpoints require iDenfy dashboard sign-in (manager account) with the MANAGE_AGE_ESTIMATION permission. They are not part of the Partner API — see Create a Session for the API-key-authenticated surface.

List Tokens

GET /age-estimation/tokens/ Returns your tokens (paginated). Supported filters:

Filter	Values	Description
`final_status`	`results`, `needs_attention`, `in_progress`, `expired`	List-page grouping (see below).
`status`	`PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `EXPIRED` (CSV)	Raw lifecycle status.
`client_id`	string	Case-insensitive contains.
`id`	exact	Exact match on the token id.
`scan_ref`	exact	Exact match on the step-up scan reference.
`created`	exact date-time	Exact match on the creation timestamp.
`order_by`	`created`, `-created`	Ordering.

final_status groupings:

Group	Meaning
`results`	`COMPLETED` with outcome `SUCCESS` or `UNDERAGE`.
`needs_attention`	Outcome `UNCERTAIN` / `FACE_MISMATCH` / `ATTEMPTS_EXCEEDED`, or status `FAILED`.
`in_progress`	`PENDING`/`PROCESSING` and not yet past `expires_at`.
`expired`	`EXPIRED`, or a session that lapsed past `expires_at`.

List item fields: id, status, outcome, estimated_age, created.

Retrieve a Token

GET /age-estimation/tokens/{id}/

Group	Fields
`result`	`status`, `estimated_age`, `outcome`
`settings`	`id`, `created`, `expires_at`, `min_age`, `buffer`, `escalation`, `retry_limit`, `save_photo`
`media`	Selfie image URL(s) — only when `save_photo` is true and the image exists (short-lived link).
`scan_ref`	Reference to the document (IDV) session created during a step-up, if any.
`identification`	Linked identification id from a document step-up, if any.

A step-up session that was accepted but flagged for possible fraud is recorded as such on the linked identification, so it remains auditable from the dashboard even though the age-estimation outcome is a normal SUCCESS / UNDERAGE.

Start Here

ID Verification (KYC)

Business Verification (KYB)

AML Screening

Face Authentication

Age Estimation

Fraud Prevention

Bank Verification

Going Live

Reference

List Tokens

Retrieve a Token

​List Tokens

​Retrieve a Token

List Tokens

Retrieve a Token