Skip to main content
GET
/
v2
/
deposit-destinations
/
{depositDestinationId}
Get deposit destination
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/deposit-destinations/{depositDestinationId} \
  --header 'Authorization: Bearer <token>'
{
  "depositDestinationId": "depositDestination_af2937b0-9846-4fe7-bfe9-ccc22d935114",
  "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
  "type": "crypto",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "network": "base",
  "metadata": {
    "customer_id": "123e4567-e89b-12d3-a456-426614174000",
    "reference": "order-12345"
  },
  "createdAt": "2023-10-08T14:30:00Z",
  "updatedAt": "2023-10-08T14:30:00Z"
}

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

​
depositDestinationId
string
required

The ID of the deposit address to retrieve. The ID of the Deposit Destination, which is a UUID prefixed by the string depositDestination_.

Example:

"depositDestination_af2937b0-9846-4fe7-bfe9-ccc22d935114"

Response

Successfully retrieved deposit destination.

A deposit destination for receiving funds to an account. Can be either a cryptocurrency address or fiat bank account instructions.

​
depositDestinationId
string
required

The ID of the Deposit Destination, which is a UUID prefixed by the string depositDestination_.

Example:

"depositDestination_af2937b0-9846-4fe7-bfe9-ccc22d935114"

​
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 deposit destination.

Available options:
crypto
Example:

"crypto"

​
address
string
required

The cryptocurrency address where funds can be deposited. Format depends on the network (e.g., 0x-prefixed for EVM networks, base58 for Solana).

Required string length: 1 - 128
Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

​
network
enum<string>
required

The blockchain network for the payment. All networks support USDC and USDT.

Available options:
base,
ethereum,
solana,
aptos,
arbitrum,
optimism,
polygon,
sui
Example:

"base"

​
createdAt
string<date-time>
required

The timestamp when the deposit destination was created.

Example:

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

​
updatedAt
string<date-time>
required

The timestamp when the deposit destination was last updated.

Example:

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

​
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 50 key/value pairs may be provided. Keys and values are both strings. Keys must be ≤ 40 characters; values must be ≤ 500 characters.

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