Mandates

List mandate revocations

Changed on

Returns all wallet revocations for the mandate, newest first. Each records an attempt to remove the spending allowance on-chain. A succeeded entry means the allowance has been removed.

get/v2/mandates/{mandateId}/revocations

Request

  • Base URL: https://api.cdp.coinbase.com/platform
  • URL: https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations
  • Auth: HTTP bearer

Path parameters

mandateIdstring required

The ID of the mandate, a UUID prefixed by mandate_.

Example:mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad

The unique identifier of the mandate.

Query parameters

pageSizeinteger

The number of resources to return per page.

pageTokenstring

The token for the next page of resources, if any.

Response

Successfully listed mandate revocations.

nextPageTokenstring

The token for the next page of items, if any.

Example response

{
  "revocations": [
    {
      "revocationId": "revocation_1a7f2b93-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
      "mandateId": "mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "status": "succeeded",
      "onchainTransactions": [
        {
          "transactionHash": "0xdef456789012345678901234567890abcdef1234567890abcdef1234567890ab",
          "network": "base"
        }
      ],
      "createdAt": "2026-08-21T14:10:00.000Z",
      "updatedAt": "2026-08-21T14:12:00.000Z"
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}

Changes