Skip to content

Stripe: External accounts schemas

2 Stripe schemas with complete fields and constraints.

← External accounts operations · All schemas

Update a bank account — external Accounts post External Accounts Id — request body — body

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
account_holder_namestringOptionalThe name of the person or business that owns the bank account.
Maximum length: 5000
account_holder_typestringOptionalThe type of entity that holds the account. This can be either `individual` or `company`.
One of: , company, individual
Maximum length: 5000
account_typestringOptionalThe bank account type. This can only be `checking` or `savings` in most countries. In Japan, this can only be `futsu` or `toza`.
One of: checking, futsu, savings, toza
Maximum length: 5000
address_citystringOptionalCity/District/Suburb/Town/Village.
Maximum length: 5000
address_countrystringOptionalBilling address country, if provided when creating card.
Maximum length: 5000
address_line1stringOptionalAddress line 1 (Street address/PO Box/Company name).
Maximum length: 5000
address_line2stringOptionalAddress line 2 (Apartment/Suite/Unit/Building).
Maximum length: 5000
address_statestringOptionalState/County/Province/Region.
Maximum length: 5000
address_zipstringOptionalZIP or postal code.
Maximum length: 5000
default_for_currencybooleanOptionalWhen set to true, this becomes the default external account for its currency.
documentsobjectOptionalDocuments that may be submitted to satisfy various informational requests.
documents.bank_account_ownership_verificationobjectOptional
documents.bank_account_ownership_verification.filesarrayOptional
documents.bank_account_ownership_verification.files[]stringEach itemMaximum length: 500
exp_monthstringOptionalTwo digit number representing the card’s expiration month.
Maximum length: 5000
exp_yearstringOptionalFour digit number representing the card’s expiration year.
Maximum length: 5000
expandarrayOptionalSpecifies which fields in the response should be expanded.
expand[]stringEach itemMaximum length: 5000
metadataJSONOptionalSet of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
metadata (anyOf 1)objectAlternativeAdditional keys: see wildcard field
metadata (anyOf 1).*stringAdditional keys
metadata (anyOf 2)stringAlternativeOne of:
namestringOptionalCardholder name.
Maximum length: 5000

Update a bank account — external Accounts post External Accounts Id — response body

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)ModelAlternativeExpand Retrieve a bank account — response body
$ (anyOf 2)ModelAlternativeExpand Retrieve a card — customers get Customers Customer Cards Id — response body

Referenced models: Retrieve a bank account — response body, Retrieve a card — customers get Customers Customer Cards Id — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.