Skip to content
Developers

List a customer's saved payment methods, newest first.

GET
/customers/{id}/payment_methods

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Customer ID

Responses

Section titled “Responses”

200

Section titled “200”

The customer’s saved payment methods

object
has_more
required
boolean
items
required
Array<object>

A saved card as returned.

The sealed token has no field here, and cannot acquire one by accident: this type is built from [SavedPaymentMethod], which does not carry the token either. The repository’s reads select a display projection and leave the ciphertext in the database, so a token would have to be fetched deliberately to reach this point at all.

object
brand

Empty until the processor supplies them — a network token response carries only the expiry today.

string | null
created
required
integer format: int64
customer_id
required

Identifier for a customer (cus_…).

string
exp_month
integer | null format: int64
exp_year
integer | null format: int64
id
required

Identifier for a stored payment method (pm_…). Declared here rather than alongside the payment method itself because Customer refers to one as its default, and the vault’s method type does not exist yet.

string
last4
string | null
livemode
required
boolean
type
required

card in v1.

string
updated
required
integer format: int64

404

Section titled “404”

No such customer

object
error
required
object
code
required
string
message
required
string
param
string | null
retryable

When present and true, the caller may retry the same request.

boolean | null
type
required
string