Skip to main content
GET
/
v2
/
payment-methods
/
{paymentMethodId}
Get a payment method
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/payment-methods/{paymentMethodId} \
  --header 'Authorization: Bearer <token>'
{
"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"
}
}

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

paymentMethodId
string
required

The unique identifier of the payment method. The ID of the Payment Method, which is a UUID prefixed by the string paymentMethod_.

Example:

"paymentMethod_8e03978e-40d5-43e8-bc93-6894a57f9324"

Response

Successfully retrieved payment method.

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).

paymentMethodId
string
required

The ID of the Payment Method, which is a UUID prefixed by the string paymentMethod_.

Example:

"paymentMethod_8e03978e-40d5-43e8-bc93-6894a57f9324"

active
boolean
required

Whether the payment method is active and can be used in transfers. A payment method may be inactive due to verification requirements or entity-level restrictions.

Example:

true

createdAt
string<date-time>
required

The timestamp when the payment method was created.

Example:

"2024-01-15T10:30:00Z"

updatedAt
string<date-time>
required

The timestamp when the payment method was last updated.

Example:

"2024-01-15T10:30:00Z"

paymentRail
enum<string>
required

The payment rail for this payment method.

Available options:
fedwire
Example:

"fedwire"

fedwire
object
required

Fedwire (domestic USD wire) details.

Example:
{
"asset": "usd",
"bankName": "ALLY BANK",
"accountLast4": "1234",
"routingNumber": "124003116"
}