List all cards

Deprecated

GET /v1/customers/{customer}/cards

Copy endpoint

https://api.stripe.com/

Parameters

path Path Parameters

Name	Type
`customer` required	string

query Query Parameters

Name	Type
`ending_before` A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.	string
`expand` Specifies which fields in the response should be expanded.	string[]
`limit` A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.	number
`starting_after` A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.	string

Request Body

application/x-www-form-urlencoded

{}

Responses

200 application/json

Successful response.

{
data:

Card

You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer to those cards later.

Related guide: Card payments with Sources

interface Card {
account?: Account | string | null;
address_city?: string | null;
address_country?: string | null;
address_line1?: string | null;
address_line1_check?: string | null;
address_line2?: string | null;
address_state?: string | null;
address_zip?: string | null;
address_zip_check?: string | null;
allow_redisplay?: "always" | "limited" | "unspecified" | null;
available_payout_methods?: ("instant" | "standard")[] | null;
brand: string;
country?: string | null;
currency?: string | null;
customer?: Customer | DeletedCustomer | string | null;
cvc_check?: string | null;
default_for_currency?: boolean | null;
dynamic_last4?: string | null;
exp_month: number;
exp_year: number;
fingerprint?: string | null;
funding: string;
id: string;
iin?: string;
last4: string;
metadata?: { } | null;
name?: string | null;
networks?: TokenCardNetworks;
object: "card";
regulated_status?: "regulated" | "unregulated" | null;
status?: string | null;
tokenization_method?: string | null;
}

[];
has_more: boolean;
object: "list";
url: string;
}

default application/json

Error response.

interface Error {
error:

ApiErrors

interface ApiErrors {
advice_code?: string;
charge?: string;
code?: string;
decline_code?: string;
doc_url?: string;
message?: string;
network_advice_code?: string;
network_decline_code?: string;
param?: string;
payment_intent?: PaymentIntent;
payment_method?: PaymentMethod;
payment_method_type?: string;
request_log_url?: string;
setup_intent?: SetupIntent;
source?: BankAccount | Card | Source;
type: "api_error" | "card_error" | "idempotency_error" | "invalid_request_error";
}

;
}