The active mandates naming the operator

GET/v1/operators/{agentId}/mandates

Lists the active mandates whose operator is agentId, with their open mandates and holds, so that the operator's agent can buy under them. Only the OAuth client that linked the operator (POST /v1/operators) reads them; any other caller gets 404. An app acting for a user (mandates:request) reads only the mandates naming agentId that this user approved for it.

Path parameters

agentIdstringRequired: The ERC-8004 agent id, a decimal integer.

Responses

200The operator's active mandates, newest first
401No valid access token
403The token lacks countersign:write
404No operator this client linked

200 response

mandatesarray of objectRequired

curl -X GET https://api.keelson.finance/v1/operators/{agentId}/mandates

const res = await fetch("https://api.keelson.finance/v1/operators/{agentId}/mandates", {
  method: "GET",
});
const data = await res.json();

Response · shape from the schema

{
  "mandates": [
    {
      "id": "string",
      "state": "ACTIVE",
      "currency": "string",
      "maxMinor": 0,
      "remainingMinor": 0,
      "expiresAt": "2026-11-11T00:00:00.000Z",
      "holdMode": "mandate",
      "authorizationId": "string",
      "openMandate": "string"
    }
  ]
}