Skip to main content
GET https://api.uip.digital/v1/sessions/{id} · Auth: Bearer API key
Returns a session’s status and progress. Verified claims and signatures are not included here — they’re delivered only by webhook. Use this to track progress or reconcile state, not to fetch results.

​
Path parameters

​
id
string
required
The session id.

​
Response

​
id
string
The session id.
​
status
string
created · in_progress · awaiting_decision · completed · stopped · failed · expired.
​
current_step
integer
Zero-based index of the active step.
​
step_count
integer
Total steps in the session.
​
primitives
string[]
The primitive of each step, in order.
​
current_primitive
string
The active step’s primitive.
​
expires_at
string
ISO 8601 session expiry.
​
created_at
string
ISO 8601 creation time.
​
updated_at
string
ISO 8601 last update.
{
  "id": "sess_abc123",
  "status": "awaiting_decision",
  "current_step": 0,
  "step_count": 2,
  "primitives": ["identify", "sign"],
  "current_primitive": "identify",
  "created_at": "2026-06-07T12:00:00Z",
  "updated_at": "2026-06-07T12:01:30Z",
  "expires_at": "2026-06-07T13:00:00Z"
}
404 if the session doesn’t exist or isn’t owned by your business.