Skip to main content
GET
/
v2
/
transfers
List transfers
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/transfers \
  --header 'Authorization: Bearer <token>'
{
  "transfers": [
    {
      "transferId": "transfer_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "status": "quoted",
      "source": {
        "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
        "asset": "usd"
      },
      "target": {
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "network": "base",
        "asset": "usdc"
      },
      "amount": "100.00",
      "asset": "usd",
      "sourceAmount": "103.50",
      "sourceAsset": "usd",
      "targetAmount": "100.00",
      "targetAsset": "usdc",
      "exchangeRate": {
        "sourceAsset": "usd",
        "targetAsset": "usdc",
        "rate": "1"
      },
      "fees": [
        {
          "name": "processing_fee",
          "amount": "2.50",
          "asset": "usd"
        },
        {
          "name": "exchange_fee",
          "amount": "1.00",
          "asset": "usd"
        }
      ],
      "createdAt": "2023-10-08T14:30:00Z",
      "updatedAt": "2023-10-08T14:30:00Z",
      "validateOnly": false,
      "metadata": {
        "invoiceId": "12345",
        "reference": "Payment for invoice #12345"
      },
      "travelRule": {
        "originator": {
          "name": "John Doe",
          "address": {
            "address1": "123 Main St",
            "address2": "Unit 201",
            "city": "Luxembourg",
            "postalCode": "L-1234",
            "country": "LU"
          },
          "financialInstitution": "Citibank"
        },
        "beneficiary": {
          "name": "Jane Smith",
          "address": {
            "address1": "456 Oak Ave",
            "city": "Paris",
            "postalCode": "75001",
            "country": "FR"
          }
        }
      }
    }
  ]
}

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

​
status
enum<string>

Filter transfers by status. Useful for building dashboards, monitoring active transfers, or finding transfers needing action. The current status of the transfer, indicating what action you need to take next.

Available options:
quoted,
processing,
completed,
failed,
canceled,
expired,
reversed
Example:

"quoted"

​
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 transfers.

​
transfers
object[]
required

The list of transfers.

​
nextPageToken
string

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

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="