APIPaymentsCustomer
Get saved payment methods for a customer
Returns canonical Easy payment-method rows for a customer at the caller's merchant. `:id` is the `easy.customers.id` (returned from `POST /v1/api/customer`), not the Finix identity id. Pass `?include_archived=true` to include soft-deleted methods.
Authorization
apiKey x-easy-api-key<token>
Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.
In: header
Path Parameters
id*string
Format
uuidQuery Parameters
include_archived?string
Value in
"true" | "false"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/v1/api/customer/497f6eca-6276-4993-bfeb-53cbbbba6f08/payment-methods"{
"success": true,
"timestamp": "2026-05-18T12:00:00.000Z",
"data": [
{
"id": "00000000-0000-0000-0000-000000000001",
"type": "PAYMENT_CARD",
"brand": "VISA",
"last4": "4242",
"exp_month": 12,
"exp_year": 2030,
"account_type": null,
"is_default": true,
"archived_at": null,
"created_at": "2026-05-01T12:00:00.000Z",
"finix_payment_instrument_id": "PIxxxxxxxxxxxxxxxxxx"
}
]
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}