List accounts

List accounts

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/accounts \
  --header 'Authorization: Bearer <token>'

{
  "accounts": [
    {
      "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "type": "prime",
      "owner": "customer_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "name": "My Business Account",
      "createdAt": "2023-10-08T14:30:00Z",
      "updatedAt": "2023-10-08T14:30:00Z"
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}

GET

accounts

List accounts

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/accounts \
  --header 'Authorization: Bearer <token>'

{
  "accounts": [
    {
      "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "type": "prime",
      "owner": "customer_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "name": "My Business Account",
      "createdAt": "2023-10-08T14:30:00Z",
      "updatedAt": "2023-10-08T14:30:00Z"
    }
  ],
  "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.

Response

Successfully listed accounts.

accounts

object[]

required

The list of accounts.

Show child attributes

accountId

string

required

The ID of the Account, which is a UUID prefixed by the string account_.

Example:

"account_af2937b0-9846-4fe7-bfe9-ccc22d935114"

type

enum<string>

required

The type of the Account.

Available options:

prime,

business,

cdp

Example:

"prime"

owner

string

required

The Owner ID, which can be either your Entity or a Customer of yours. Owner IDs are UUIDs prefixed with the Owner Type as follows:

Entity: entity_ - If the Owner is your Entity, e.g. entity_af2937b0-9846-4fe7-bfe9-ccc22d935114
Customer: customer_ - If the Owner is a Customer of yours, e.g. customer_af2937b0-9846-4fe7-bfe9-ccc22d935114.

Example:

"customer_af2937b0-9846-4fe7-bfe9-ccc22d935114"

createdAt

string<date-time>

required

The timestamp when the account was created.

Example:

"2023-10-08T14:30:00Z"

updatedAt

string<date-time>

required

The timestamp when the account was last updated.

Example:

"2023-10-08T14:30:00Z"

name

string

An optional name for the account. Must be 1-64 characters and can only contain alphanumeric characters, hyphens, and spaces.

Maximum length: 64

Example:

"My Business Account"

nextPageToken

string

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

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="

Get balance for account

List balances for account

⌘I

CDP PAYMENTS API

REST API

Authorizations

Query Parameters

Response