Skip to main content
GET
/
v2
/
disbursements
List disbursements
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/disbursements \
  --header 'Authorization: Bearer <token>'
{
  "disbursements": [
    {
      "disbursementId": "disbursement_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "source": {
        "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
        "asset": "usdc"
      },
      "target": {
        "coinbaseUserId": "coinbase_user_abc123"
      },
      "amount": "25.00",
      "asset": "usdc",
      "status": "succeeded",
      "reason": "Goodwill disbursement for delayed shipment.",
      "externalReferenceId": "disbursement-2026-04-1234",
      "metadata": {
        "customer_id": "cust_12345",
        "order_id": "order_67890"
      },
      "onchainTransactions": [
        {
          "transactionHash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456",
          "network": "base"
        }
      ],
      "createdAt": "2026-04-17T17:00:00.000Z",
      "updatedAt": "2026-04-17T17:05:00.000Z"
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}

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.

Query Parameters

pageSize
integer
default:20

The number of resources to return per page.

pageToken
string

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

status
enum<string>

Filter disbursements by status. The current status of a payment action (authorization, capture, void, or refund).

Available options:
pending,
succeeded,
failed
Example:

"pending"

sourceAccountId
string

Filter disbursements by the source CDP account ID.

externalReferenceId
string

Filter disbursements by the client-supplied external reference ID.

Response

Successfully listed disbursements.

disbursements
object[]
required

The list of disbursements.

nextPageToken
string

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

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="