List mandates

GET /mandates · Mandates · version 2026-09-14

A page of mandates, filtered by granter, agent or status.

Cursor pagination. Pass next_cursor from the previous page to continue; a null next_cursor means you have the last page.

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.
granted_by	query	string	optional	FaceToken of the granter.
granted_to	query	string	optional	Identifier of the agent.
status	query	enum	optional	Filter by lifecycle state.
cursor	query	string	optional	next_cursor from the previous page.
limit	query	integer	optional	1–100. Defaults to 25.

Responses

200 — A page of mandates

Newest first. next_cursor is null on the last page.

{
  "data": [
    {
      "id": "mnd_9f41c7b2",
      "status": "active",
      "granted_to": "agent_7f2c",
      "scope": [
        "payment"
      ],
      "ceiling": {
        "amount": 200,
        "currency": "USD",
        "period": "month"
      },
      "remaining": 160,
      "until": "2027-03-01T00:00:00Z"
    }
  ],
  "next_cursor": null
}

Errors

rate_limited. See errors and refusals.

Notes

status is a derived field. A mandate becomes expired at until and exhausted when the ceiling reaches zero, with no call from you.

Listing is a read: it consumes nothing and is never billed.