Retrieve a mandate

GET /mandates/{id} · Mandates · version 2026-09-14

The mandate as issued, with what is left of its ceiling.

remaining is the live figure the rail will enforce on the next check, not a cached one.

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 mandate id returned at creation.

Responses

200 — The mandate

With its remaining ceiling and current status.

{
  "id": "mnd_9f41c7b2",
  "status": "active",
  "granted_by": "0xA1f3c9b27d04",
  "granted_to": "agent_7f2c",
  "scope": [
    "payment"
  ],
  "ceiling": {
    "amount": 200,
    "currency": "USD",
    "period": "month"
  },
  "remaining": 160,
  "until": "2027-03-01T00:00:00Z",
  "created_at": "2026-09-14T11:04:03Z",
  "receipt": {
    "id": "rcpt_9f41c7b2",
    "anchor": "0x7c3d91a4f8e2",
    "url": "https://verify.sidaxis.com/r/9f41c7b2"
  }
}

Errors

not_found, rate_limited. See errors and refusals.

Notes

A revoked mandate is still retrievable. The record does not disappear when the authority does.