Read a session result

GET /sessions/{id} · Hosted · version 2026-09-14

The authoritative outcome of a hosted session, and the ids it produced.

Call this when the webhook arrives, or when the person comes back to your return_url. Treat this response as the truth — the query string on the redirect is a hint, not a result.

result carries whatever the mode produced: a facetoken, a recognition, an answer, or a mandate id.

Base URL

https://api.sidaxis.com/v1 in production, https://sandbox.api.sidaxis.com/v1 in sandbox.

Parameters

Name	In	Type	Required	Description
Authorization	header	string	required	Bearer sk_live_… in production, sk_test_… in sandbox.
id	path	string	required	The session id.

Responses

200 — The session

status is open, completed, expired or cancelled.

{
  "id": "ses_2a91c4f7",
  "status": "completed",
  "mode": "mandate",
  "result": {
    "facetoken": "0xA1f3c9b27d04",
    "mandate_id": "mnd_9f41c7b2"
  },
  "completed_at": "2026-09-14T11:07:44Z",
  "receipt": {
    "id": "rcpt_9f41c7b2",
    "anchor": "0x7c3d91a4f8e2",
    "url": "https://verify.sidaxis.com/r/9f41c7b2"
  }
}

Errors

not_found, session_expired, rate_limited. See errors and refusals.

Notes

A session that was never finished reads as expired, not as an error.

Idempotent and never billed, so it is safe to poll — though the webhook is cheaper for both of us.

cancelled means the person declined. That is an outcome, not a failure.