Get a mandate revocation

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "errorType": "not_found",
  "errorMessage": "Revocation with the given ID does not exist for this mandate."
}

{
  "errorType": "internal_server_error",
  "errorMessage": "An internal server error occurred. Please try again later."
}

{
  "errorType": "bad_gateway",
  "errorMessage": "Bad gateway. Please try again later."
}

{
  "errorType": "service_unavailable",
  "errorMessage": "Service unavailable. Please try again later."
}

GET

mandates

{mandateId}

revocations

{revocationId}

Get a mandate revocation

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/mandates/{mandateId}/revocations/{revocationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "errorType": "not_found",
  "errorMessage": "Revocation with the given ID does not exist for this mandate."
}

{
  "errorType": "internal_server_error",
  "errorMessage": "An internal server error occurred. Please try again later."
}

{
  "errorType": "bad_gateway",
  "errorMessage": "Bad gateway. Please try again later."
}

{
  "errorType": "service_unavailable",
  "errorMessage": "Service unavailable. Please try again later."
}

Authorizations

Authorization

string

header

required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

mandateId

string

required

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

Pattern: ^mandate_[a-f0-9\-]{36}$

Example:

"mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad"

revocationId

string

required

The unique identifier of the revocation. The ID of a revocation, a UUID prefixed by revocation_.

Pattern: ^revocation_[a-f0-9\-]{36}$

Example:

"revocation_9d2e7c14-3b8a-4f21-9c66-2a1e5d7b8f03"

Response

Successfully retrieved mandate revocation.

A record of a wallet revocation: the customer removing the mandate's spending allowance on-chain (see onchainTransactions). While it is confirming, the mandate's status is revocation_pending; on success it becomes revocation_succeeded and the mandate's revokedAt is set, and on failure it becomes revocation_failed. This applies regardless of whether the mandate was previously canceled: a revocation on an already-canceled mandate still moves status through the revocation_* values and sets revokedAt.

To check whether the spending allowance is still active, read the mandate: revokedAt is set once the allowance has been removed.

revocationId

string

required

The unique identifier of the revocation.

Pattern: ^revocation_[a-f0-9\-]{36}$

Example:

"revocation_9d2e7c14-3b8a-4f21-9c66-2a1e5d7b8f03"

mandateId

string

required

The unique identifier of the mandate this revocation applies to.

Pattern: ^mandate_[a-f0-9\-]{36}$

Example:

"mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad"

status

enum<string>

required

The current status of the revocation attempt.

Available options:

pending,

succeeded,

failed

Example:

"succeeded"

createdAt

string<date-time>

required

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

Example:

"2026-08-21T14:10:00.000Z"

updatedAt

string<date-time>

required

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

Example:

"2026-08-21T14:12:00.000Z"

onchainTransactions

object[]

Network transactions that remove the spending allowance on-chain. Empty until the revocation has been submitted to the network.

Show child attributes

Example:

[
  {
    "transactionHash": "0xdef456789012345678901234567890abcdef1234567890abcdef1234567890ab",
    "network": "base"
  }
]

error

object

Details of why the revocation failed. Only present when status is failed.

Show child attributes

Example:

{
  "code": "transaction_reverted",
  "message": "The revocation transaction reverted on-chain.",
  "occurredAt": "2026-08-21T14:12:00.000Z"
}

metadata

object

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.

Show child attributes

Example:

{
  "customer_id": "cust_12345",
  "order_reference": "order-67890"
}