Skip to main content
GET
/
api
/
canary
/
customers
/
{id}
/
payment-methods
Shows all saved payment methods (cards, etc.) for a single customer.

​
Path Parameters

​
id
string
required
The unique identifier of the customer

​
Query Parameters

​
offset
number
Number of payment methods to skip (default: 0)
​
limit
number
Maximum number of payment methods to return (default: 50)

​
Response

​
Success
​
data
array
Array of payment methods
​
pagination
object
Pagination information

​
Example Response

{
  "data": [
    {
      "id": "pm_001",
      "customerId": "customer_789",
      "type": "card",
      "brand": "visa",
      "last4": "4242",
      "expiryMonth": 12,
      "expiryYear": 2025,
      "holderName": "John Doe",
      "isDefault": true,
      "createdAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-01-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "hasMore": false
  }
}

​
Error Responses

​
Unauthorized
Invalid or missing authentication token
​
Not Found
Customer not found
​
Internal Server Error
An unexpected error occurred on the server

​
Authentication

This endpoint requires Bearer token authentication.