> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Tokens

> List and inspect age estimation sessions from the iDenfy Dashboard, including filters, status groupings, and step-up detail.

<Note>
  **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](/age-estimation/create-session) for the API-key-authenticated surface.
</Note>

## 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`.


## Related topics

- [Age Estimation](/age-estimation/overview.md)
- [Create a Session](/age-estimation/create-session.md)
- [Retrieve session](/api-reference/face-auth-sessions/retrieve-session.md)
- [Retrieve questionnaire](/api-reference/kyb-questionnaires/retrieve-questionnaire.md)
- [Retrieve KYB session info](/api-reference/kyb-token/retrieve-kyb-session-info.md)