---
title: "List a customer's saved payment methods"
method: GET
path: "/v1/gateway/customers/{customerId}/payment-methods"
tags: ["Direct Payment"]
---

# List a customer's saved payment methods

`GET /v1/gateway/customers/{customerId}/payment-methods`

List the active saved cards stored on a Breeze customer (`cus_*`). Each entry includes display metadata plus the opaque `saved_*` identifier you re-submit as a `SAVED_CARD` payment method on `POST /v1/gateway/payments`. Removed (inactive) cards are not returned.

> **Base URL** — call this on the default `api.breeze.cash` host.

## Path parameters

- `customerId` string, required

## Query parameters

- `type` 'card', required — Saved payment method type to list (required).

## Response `200`

Success

- object — The customer's saved payment methods
  - `status` 'SUCCEEDED', required
  - `data` object[], required
    - `savedPaymentMethodId` string, required
    - `scheme` string, required
    - `last4` string, required
    - `expiryMonth` number, required
    - `expiryYear` number, required
    - `expiryStatus` 'active' | 'expired' | 'expiring', required
    - `storeFutureUsage` 'on_session' | 'off_session'

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.dev/breeze/apis/breeze-api.md) · [All operations](https://skmtc.dev/breeze/apis/breeze-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/breeze/breeze-api/revisions/8911892bdf29/schema)