Mandates

Get wallet revocation options

Changed on

Returns the payloads the customer must sign to remove the mandate's spending allowance on-chain. The mandate must have an active allowance (approval succeeded, not yet revoked) and no approval or revocation in flight. A canceled mandate can still be revoked while its allowance is live.

Present the payloads to the customer to sign, then call Revoke a mandate with a wallet with the signed payloads.

This is a stateless read operation and does not modify the mandate. The payloads embed fresh signing data on each call, so sign and submit the payloads from a single response rather than caching them.

get/v2/mandates/{mandateId}/revocations/wallet/options

Request

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

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.

Response

Successfully retrieved wallet revocation options.

Example response

{
  "options": [
    {
      "optionId": "opt_b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "source": {
        "address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
        "network": "base",
        "asset": "usdc"
      },
      "payloads": [
        {
          "payloadId": "payload_bf3048c1-0957-5gf8-cgf0-ddd33e046225",
          "type": "eip2612",
          "data": {
            "types": {
              "EIP712Domain": [
                {
                  "name": "name",
                  "type": "string"
                },
                {
                  "name": "version",
                  "type": "string"
                },
                {
                  "name": "chainId",
                  "type": "uint256"
                },
                {
                  "name": "verifyingContract",
                  "type": "address"
                }
              ],
              "Permit": [
                {
                  "name": "owner",
                  "type": "address"
                },
                {
                  "name": "spender",
                  "type": "address"
                },
                {
                  "name": "value",
                  "type": "uint256"
                },
                {
                  "name": "nonce",
                  "type": "uint256"
                },
                {
                  "name": "deadline",
                  "type": "uint256"
                }
              ]
            },
            "primaryType": "Permit",
            "domain": {
              "name": "USD Coin",
              "version": "2",
              "chainId": 8453,
              "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
            },
            "message": {
              "owner": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
              "spender": "0x9Fb909eA400c2b8D99Be292DADf07e63B814527c",
              "value": "0",
              "nonce": "1",
              "deadline": "1798761600"
            }
          }
        }
      ]
    }
  ]
}

Changes