List all bank accounts

Deprecated

GET /v1/customers/{customer}/bank_accounts

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:

BankAccount

These bank accounts are payment methods on Customer objects.

On the other hand External Accounts are transfer destinations on Account objects for connected accounts. They can be bank accounts or debit cards as well, and are documented in the links above.

Related guide: Bank debits and transfers

interface BankAccount {
account?: Account | string | null;
account_holder_name?: string | null;
account_holder_type?: string | null;
account_type?: string | null;
available_payout_methods?: ("instant" | "standard")[] | null;
bank_name?: string | null;
country: string;
currency: string;
customer?: Customer | DeletedCustomer | string | null;
default_for_currency?: boolean | null;
fingerprint?: string | null;
future_requirements?: ExternalAccountRequirements | null;
id: string;
last4: string;
metadata?: { } | null;
object: "bank_account";
requirements?: ExternalAccountRequirements | null;
routing_number?: string | null;
status: string;
}

[];
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";
}

;
}