Skip to main content
GET
/
v2
/
payment-methods
List payment methods
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/payment-methods \
  --header 'Authorization: Bearer <token>'
{
  "paymentMethods": [
    {
      "paymentMethodId": "paymentMethod_8e03978e-40d5-43e8-bc93-6894a57f9324",
      "paymentRail": "fedwire",
      "active": true,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "fedwire": {
        "asset": "usd",
        "bankName": "ALLY BANK",
        "accountLast4": "1234",
        "routingNumber": "124003116"
      }
    },
    {
      "paymentMethodId": "paymentMethod_def45678-1234-5678-9abc-def012345678",
      "paymentRail": "swift",
      "active": true,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "swift": {
        "asset": "eur",
        "bankName": "Deutsche Bank",
        "ibanLast4": "5678",
        "bic": "DEUTDEFF"
      }
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyJ9"
}

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 payment methods.

​
paymentMethods
(FedwirePaymentMethod · object | SwiftPaymentMethod · object)[]
required

The list of payment methods.

A payment method linked to your entity. Payment methods represent external financial instruments that can be used as a target for transfers.

The paymentRail field indicates which type-specific details object is present. Type-specific fields are nested under a key matching the rail name (e.g., fedwire, swift).

Example:
{
  "paymentMethodId": "paymentMethod_8e03978e-40d5-43e8-bc93-6894a57f9324",
  "paymentRail": "fedwire",
  "active": true,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "fedwire": {
    "asset": "usd",
    "bankName": "ALLY BANK",
    "accountLast4": "1234",
    "routingNumber": "124003116"
  }
}
​
nextPageToken
string

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

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="