Toolcog home
Search ⌘ + K

Command Palette

Search for a command to run...

Sign In

Retrieve a bank account

Deprecated
GET /v1/customers/{customer}/bank_accounts/{id}
Copy endpoint
https://api.stripe.com/

Parameters

path Path Parameters

Name Type
customer required
string
id required
string

query Query Parameters

Name Type
expand

Specifies which fields in the response should be expanded.
string[]

Request Body

application/x-www-form-urlencoded
{}

Responses

200 application/json

Successful response.

interface BankAccount {
account?: Account

This is an object representing a Stripe account. You can retrieve it to see properties on the account like its current requirements or if the account is enabled to make live charges or receive payouts.

For accounts where controller.requirement_collection is application, which includes Custom accounts, the properties below are always returned.

For accounts where controller.requirement_collection is stripe, which includes Standard and Express accounts, some properties are only returned until you create an Account Link or Account Session to start Connect Onboarding. Learn about the differences between accounts.

interface Account {
business_profile?: AccountBusinessProfile | null;
business_type?: "company" | "government_entity" | "individual" | "non_profit" | null;
capabilities?: AccountCapabilities;
charges_enabled?: boolean;
company?: LegalEntityCompany;
controller?: AccountUnificationAccountController;
country?: string;
created?: number;
default_currency?: string;
details_submitted?: boolean;
email?: string | null;
external_accounts?: {
data: (BankAccount | Card)[];
has_more: boolean;
object: "list";
url: string;
};
future_requirements?: AccountFutureRequirements;
groups?: AccountGroupMembership | null;
id: string;
individual?: Person;
metadata?: { };
object: "account";
payouts_enabled?: boolean;
requirements?: AccountRequirements;
settings?: AccountSettings | null;
tos_acceptance?: AccountTosAcceptance;
type?: "custom" | "express" | "none" | "standard";
}
| 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

This object represents a customer of your business. Use it to create recurring charges, save payment and contact information, and track payments that belong to the same customer.

interface Customer {
address?: Address | null;
balance?: number;
business_name?: string;
cash_balance?: CashBalance | null;
created: number;
currency?: string | null;
customer_account?: string | null;
default_source?: BankAccount | Card | Source | string | null;
delinquent?: boolean | null;
description?: string | null;
discount?: Discount | null;
email?: string | null;
id: string;
individual_name?: string;
invoice_credit_balance?: { };
invoice_prefix?: string | null;
invoice_settings?: InvoiceSettingCustomerSetting;
livemode: boolean;
metadata?: { };
name?: string | null;
next_invoice_sequence?: number;
object: "customer";
phone?: string | null;
preferred_locales?: string[] | null;
shipping?: Shipping | null;
sources?: {
data: (BankAccount | Card | Source)[];
has_more: boolean;
object: "list";
url: string;
};
subscriptions?: {
data: Subscription[];
has_more: boolean;
object: "list";
url: string;
};
tax?: CustomerTax;
tax_exempt?: "exempt" | "none" | "reverse" | null;
tax_ids?: {
data: TaxId[];
has_more: boolean;
object: "list";
url: string;
};
test_clock?: TestHelpersTestClock | string | null;
}
| DeletedCustomer
interface DeletedCustomer {
deleted: true;
id: string;
object: "customer";
}
| string | null;
default_for_currency?: boolean | null;
fingerprint?: string | null;
future_requirements?: ExternalAccountRequirements
interface ExternalAccountRequirements {
currently_due?: string[] | null;
errors?: AccountRequirementsError[] | null;
past_due?: string[] | null;
pending_verification?: string[] | null;
}
| null;
id: string;
last4: string;
metadata?: { } | null;
object: "bank_account";
requirements?: ExternalAccountRequirements
interface ExternalAccountRequirements {
currently_due?: string[] | null;
errors?: AccountRequirementsError[] | null;
past_due?: string[] | null;
pending_verification?: string[] | null;
}
| null;
routing_number?: string | null;
status: 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";
}
;
}