Create a Session

Requirements:

API key pair (API key + secret), for the Partner API surface
Age Estimation feature enabled on your contract (contact iDenfy to activate)
Sufficient balance for the age-estimation fee (and a document scan when escalation is DOC)

Age Estimation is exposed on two separate surfaces. Both create the same token object and are scoped to your partner account (you only ever see your own sessions).

Surface	Authentication	Endpoint
Partner API	Your API key + secret (API key pair)	`POST /age-estimation/token/` — create a session
Dashboard (Admin)	iDenfy dashboard sign-in (manager account) with the `MANAGE_AGE_ESTIMATION` permission	`POST /age-estimation/tokens/` — create · `GET /age-estimation/tokens/` — list · `GET /age-estimation/tokens/{id}/` — detail

Use the Partner API (API key pair) to create sessions programmatically from your backend. This is the surface you integrate against.
Use the Dashboard (Admin) surface to create, browse, and inspect sessions in the iDenfy admin UI. Listing and per-session detail are dashboard-only — see Retrieve Tokens.

Both surfaces accept the same request body and return the same token object. On creation your balance is checked for the age-estimation fee (and, when escalation = DOC, also for a document scan); if funds are insufficient the request is rejected.

The API Reference page for this endpoint isn’t published yet. Once Age Estimation is released, it will appear there automatically with the full request/response schema and an interactive playground — no further changes needed on this page.

Example (Partner API)

Request
Response

POST /age-estimation/token/
Authorization: Basic {API_KEY}:{API_SECRET}
Content-Type: application/json

{
  "min_age": 18,
  "confidence_threshold": 85,
  "buffer": 2,
  "escalation": "DOC",
  "save_photo": true,
  "expiry_minutes": 60,
  "success_redirect": "https://partner.example.com/ok",
  "underage_redirect": "https://partner.example.com/denied",
  "webhook_url": "https://partner.example.com/hooks/age",
  "client_id": "user-42"
}

{
  "token": "b7c1…",
  "session_url": "https://capture.idenfy.example/?token=b7c1…",
  "expires_at": "2026-07-14T12:00:00+00:00",
  "min_age": 18,
  "confidence_threshold": 85.0,
  "buffer": 2,
  "escalation": "DOC",
  "retry_limit": 3,
  "save_photo": true,
  "expiry_minutes": 60,
  "client_id": "user-42"
}

What’s Next

Once you have a session_url, send the end user to it to complete the selfie capture. When the session finishes, the result is delivered via the result webhook (if configured) and is always available through Retrieve Tokens on the Dashboard.

Start Here

ID Verification (KYC)

Business Verification (KYB)

AML Screening

Face Authentication

Age Estimation

Fraud Prevention

Bank Verification

Going Live

Reference

Create a Session

Create a Session

Example (Partner API)

What’s Next

​Create a Session

​Example (Partner API)

​What’s Next

Create a Session

Example (Partner API)

What’s Next