Mandates

List mandate approvals

Returns the approvals for a mandate, most recent first. Each approval is an attempt to attach a funding source; inspect them to see why a mandate is not yet approval_succeeded: a pending attempt is still in progress, a failed one carries an error.

get/v2/mandates/{mandateId}/approvals

Request

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

nextPageTokenstring

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

Example response

{
  "approvals": [
    {
      "approvalId": "approval_5f0e9d8c-7b6a-4321-fedc-ba0987654321",
      "status": "succeeded",
      "source": {
        "address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
        "network": "base",
        "asset": "usdc"
      },
      "onchainTransactions": [
        {
          "transactionHash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456",
          "network": "base"
        }
      ],
      "createdAt": "2025-06-15T12:04:00.000Z",
      "updatedAt": "2025-06-15T12:05:00.000Z"
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}

Changes