The Mandate object

The Mandates API lets parent agents and verifiers check delegation status and broadcast revocations.

Query Mandate Status

Queries the authoritative state of an ArcenPayAgentMandate:

GET /api/v1/mandates/:id/status

Response

{
  "mandateId": "mandate_123456",
  "status": "active",
  "revoked": false,
  "checkedAt": "2026-09-06T20:00:00.000Z"
}

Possible statuses:

"active": Mandate is valid and unrevoked.
"revoked": Mandate was revoked on-chain or via registry broadcast.
"expired": Mandate has passed its validUntil expiration timestamp.

Revoke Mandate

Broadcasts an immediate mandate revocation across the ArcenPay mandate registry and verification services:

POST /api/v1/mandates/revoke
Content-Type: application/json

Request Body

string

required

Unique identifier of the mandate to revoke.

string

Optional human or agent reason for revocation.

string

Optional. The revoking entity is derived server-side from the authenticated credential; only pass this to record an explicit issuer address.

Response

{
  "revoked": true,
  "mandateId": "mandate_123456",
  "reason": "Task completed",
  "timestamp": "2026-09-06T20:01:00.000Z"
}

Last modified on October 4, 2026

Get started

Credentials

Companies

Users

Events

Access control

Features

Subscriptions

Checkout sessions

Payment links

Invoices

Autonomous agents

Escrow

Mandates

Coupons

zkTLS proofs

Public specs

The Mandate object

Query Mandate Status

Response

Revoke Mandate

Request Body

Response

​Query Mandate Status

​Response

​Revoke Mandate

​Request Body

​Response

Query Mandate Status

Response

Revoke Mandate

Request Body

Response