Sign in
Mandates

Get a mandate revocation

Changed on

Retrieves a single revocation by ID.

get/v2/mandates/{mandateId}/revocations/{revocationId}

Request

  • Base URL: https://api.cdp.coinbase.com/platform
  • URL: https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}
  • 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.

revocationIdstring required

The ID of a revocation, a UUID prefixed by revocation_.

Example:revocation_9d2e7c14-3b8a-4f21-9c66-2a1e5d7b8f03

The unique identifier of the revocation.

Response

Successfully retrieved mandate revocation.

revocationIdstring required

The ID of a revocation, a UUID prefixed by revocation_.

mandateIdstring required

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

status'pending' | 'succeeded' | 'failed' required

The status of a wallet revocation attempt:

  • pending: awaiting network confirmation.

  • succeeded: the spending allowance has been removed on-chain.

  • failed: the revocation did not complete (see error).

metadataMetadata

Optional metadata as key-value pairs. Use this to store additional structured information on a resource, such as customer IDs, order references, or any application-specific data. Up to 10 key/value pairs may be provided. Keys and values are both strings. Keys must be ≤ 40 characters; values must be ≤ 500 characters.

createdAtstring date-time required

The UTC ISO 8601 timestamp at which the revocation was created.

updatedAtstring date-time required

The UTC ISO 8601 timestamp at which the revocation was last updated.

Example response

{
  "revocationId": "revocation_9d2e7c14-3b8a-4f21-9c66-2a1e5d7b8f03",
  "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"
}

Changes