---
title: "List customer payment methods"
method: GET
path: "/customers/{id}/payment-methods"
tags: ["Customers"]
---

# List customer payment methods

`GET /customers/{id}/payment-methods`

## Request

- Base URL: `https://us.api.flexprice.io/v1`
- URL: `https://us.api.flexprice.io/v1/customers/{id}/payment-methods`
- Auth: API key in header `x-api-key`

Use when you need a customer's saved payment methods across every connected gateway, including whether each can be auto-charged. Only gateways that can list saved methods are included.

## Path parameters

- `id` string, required

## Query parameters

- `providers` string[]

## Response `200`

OK

- SavedPaymentMethodsResponse
  - `providers` ProviderSavedPaymentMethods[]
    - `error` ProviderError
      - `message` string
    - `items` SavedPaymentMethod[]
      - `can_auto_charge` boolean: Capability, not permission: could this be charged with nobody present. True for any active Chargebee or Stripe card (both vault off-session by construction); false for a Razorpay token without a mandate.
      - `card` SavedCardDetails
        - `brand` string
        - `exp_month` integer
        - `exp_year` integer
        - `last4` string
      - `id` string
      - `instantly_chargeable` boolean
      - `is_default` boolean: Which method to use when several are saved at this provider. Scoped to the provider: two providers means two defaults.
      - `provider` 'stripe' | 'razorpay' | 'nomod' | 'moyasar' | 'paddle' | 'whop' | 'chargebee'
      - `recurring` SavedRecurringPaymentDetails
        - `auto_chargeable_till` string
        - `max_amount` string
        - `status` 'PENDING' | 'ACTIVE' | 'PAUSED' | 'REJECTED' | 'CANCELLED' | 'EXPIRED' | 'UNKNOWN'
      - `status` 'ACTIVE' | 'INACTIVE' | 'EXPIRED'
      - `type` 'CARD' | 'ACH' | 'OFFLINE' | 'CREDITS' | 'PAYMENT_LINK' | 'UPI'
      - `upi` SavedUPIDetails
        - `vpa` string
    - `provider` 'stripe' | 'razorpay' | 'nomod' | 'moyasar' | 'paddle' | 'whop' | 'chargebee'

## Other responses

- `400`: Invalid request
- `404`: Customer not found
- `500`: Server error

## Changes

- **2026-09-29** `73762376b805`: 1 info
  - endpoint added
- **2026-09-28** `fa71deaf653b`: 1 breaking
  - api path removed without deprecation
- **2026-09-27** `7365ad687fc8`: 1 warning, 1 info
  - removed the optional property `providers/items/items/items/recurring/instantly_chargeable` from the response with the `200` status
  - added the optional property `providers/items/items/items/instantly_chargeable` to the response with the `200` status
- **2026-09-27** `758871229df8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/customers/:id/payment-methods/get.md)

---

[API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [All operations](https://skmtc.dev/flexprice/apis/flexprice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flexprice/apis/flexprice-api/revisions/84cb4a3af400?raw)