Get a session

{
  "id": "sess_abc123",
  "status": "awaiting_decision",
  "current_step": 1,
  "step_count": 2,
  "results": [
    {
      "step": 0,
      "primitive": "identify",
	  "country": "US",
	  "wallet": "google-wallet",
	  "credential_profile": "us-mdl",
      "verified_at": "2026-06-07T12:01:30Z",
      "audit_id": "sess_abc123_0",
      "claims": {
        "first_name": "Ada",
        "last_name": "Lovelace",
        "dob": "1815-12-10",
        "country": "US"
      }
    }
  ],
  "outcome": "",
  "metadata": { "order_id": "order_4417", "checkout": "abc" },
  "workflow": {
    "id": "wf_customer_onboarding",
    "name": "Customer onboarding",
    "revision": 3,
    "definition_hash": "sha256:...",
    "launch_mode": "api_only"
  },
  "updated_at": "2026-06-07T12:01:30Z"
}

{
  "id": "sess_abc123",
  "status": "awaiting_decision",
  "current_step": 1,
  "step_count": 2,
  "results": [
    {
      "step": 0,
      "primitive": "identify",
	  "country": "US",
	  "wallet": "google-wallet",
	  "credential_profile": "us-mdl",
      "verified_at": "2026-06-07T12:01:30Z",
      "audit_id": "sess_abc123_0",
      "claims": {
        "first_name": "Ada",
        "last_name": "Lovelace",
        "dob": "1815-12-10",
        "country": "US"
      }
    }
  ],
  "outcome": "",
  "metadata": { "order_id": "order_4417", "checkout": "abc" },
  "workflow": {
    "id": "wf_customer_onboarding",
    "name": "Customer onboarding",
    "revision": 3,
    "definition_hash": "sha256:...",
    "launch_mode": "api_only"
  },
  "updated_at": "2026-06-07T12:01:30Z"
}

GET https://api.alentra.app/v1/sessions/{id} · Auth: Bearer API key

Returns a session’s status, progress, and the derived per-step results already produced — the same verdicts delivered by webhook. The requested claims are returned for non-anonymous primitives. age_verify is the one business-redacted result: it returns only satisfied and min_age; its identity stays sealed in the audit. Webhooks remain the push mechanism — use GET for one-off reconciliation, not as a polling loop.

Path parameters

string

required

The session id.

Response

string

The session id.

string

created · in_progress · awaiting_decision · completed · stopped · failed · expired.

integer

Zero-based index of the active step.

integer

Total steps in the session.

object[]

Results produced so far, one per completed step — the same business disclosure delivered by webhook. age_verify alone withholds its signer claims.

Show result

integer

Zero-based index of the step this verdict belongs to.

string

The step’s primitive (identify · age_verify · light_sign · sign).

string

Non-anonymous results — route jurisdiction.

string

Non-anonymous results — presentation provider id.

string

Non-anonymous results — verified credential profile id.

string

ISO 8601 time the verdict was produced.

string

Id of the immutable audit record. Fetch the business-authorized record via GET /v1/audits/{id}.

boolean

age_verify only — whether age >= min_age.

integer

age_verify only — the threshold checked.

object

identify, light_sign, and sign — disclosed identity attributes. Signing steps request the default signer fields.

string

sign / light_sign only — the hash the wallet device-signed.

string

sign / light_sign only — the wallet signature over the hash.

string

Terminal reason — completed · stopped · failed · expired. Empty while the session is still in progress.

object

Optional — echoed back if you supplied it at create.

object

The immutable workflow snapshot identity: id, name, revision, definition_hash, and launch_mode.

string

ISO 8601 last update.

{
  "id": "sess_abc123",
  "status": "awaiting_decision",
  "current_step": 1,
  "step_count": 2,
  "results": [
    {
      "step": 0,
      "primitive": "identify",
	  "country": "US",
	  "wallet": "google-wallet",
	  "credential_profile": "us-mdl",
      "verified_at": "2026-06-07T12:01:30Z",
      "audit_id": "sess_abc123_0",
      "claims": {
        "first_name": "Ada",
        "last_name": "Lovelace",
        "dob": "1815-12-10",
        "country": "US"
      }
    }
  ],
  "outcome": "",
  "metadata": { "order_id": "order_4417", "checkout": "abc" },
  "workflow": {
    "id": "wf_customer_onboarding",
    "name": "Customer onboarding",
    "revision": 3,
    "definition_hash": "sha256:...",
    "launch_mode": "api_only"
  },
  "updated_at": "2026-06-07T12:01:30Z"
}

404 if the session doesn’t exist; 403 if it belongs to another active business. An archived/billing-frozen business’s key is rejected during authentication (401).

Overview

Sessions

Audits

Discovery

Webhooks

Path parameters

Response

​Path parameters

​Response

Path parameters

Response