Schema2020-08-27object

account

This is an object representing a Stripe account. You can retrieve it to see properties on the account like its current e-mail address or if the account is enabled yet to make live charges. Some properties, marked below, are available only to platforms that want to [create and manage Express or Custom accounts](https://stripe.com/docs/connect/accounts).

Source: openapi/spec3.json
Commit: d70de345383d
Active snapshot: da69df7e6e11

Address

object

city string

optionalnullable

City, district, suburb, town, or village.

maxLength:5000

country string

optionalnullable

Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

maxLength:5000

line1 string

optionalnullable

Address line 1 (e.g., street, PO Box, or company name).

maxLength:5000

line2 string

optionalnullable

Address line 2 (e.g., apartment, suite, unit, or building).

maxLength:5000

postal_code string

optionalnullable

ZIP or postal code.

maxLength:5000

state string

optionalnullable

State, county, province, or region.

maxLength:5000

Root JSON Schema

{"description":"This is an object representing a Stripe account. You can retrieve it to see\nproperties on the account like its current e-mail address or if the account is\nenabled yet to make live charges.\n\nSome properties, marked below, are available only to platforms that want to\n[create and manage Express or Custom accounts](https://stripe.com/docs/connect/accounts).","properties":{"business_profile":{"anyOf":[{"$ref":"#/components/schemas/account_business_profile"}],"description":"Business information about the account.","nullable":true},"business_type":{"description":"The business type.","enum":["company","government_entity","individual","non_profit"],"nullable":true,"type":"string","x-stripeBypassValidation":true},"capabilities":{"$ref":"#/components/schemas/account_capabilities"},"charges_enabled":{"description":"Whether the account can create live charges.","type":"boolean"},"company":{"$ref":"#/components/schemas/legal_entity_company"},"controller":{"$ref":"#/components/schemas/account_unification_account_controller"},"country":{"description":"The account's country.","maxLength":5000,"type":"string"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"default_currency":{"description":"Three-letter ISO currency code representing the default currency for the account. This must be a currency that [Stripe supports in the account's country](https://stripe.com/docs/payouts).","maxLength":5000,"type":"string"},"details_submitted":{"description":"Whether account details have been submitted. Standard accounts cannot receive payouts before this is true.","type":"boolean"},"email":{"description":"An email address associated with the account. You can treat this as metadata: it is not used for authentication or messaging account holders.","maxLength":5000,"nullable":true,"type":"string"},"external_accounts":{"description":"External accounts (bank accounts and debit cards) currently attached to this account","properties":{"data":{"description":"The list contains all external accounts that have been attached to the Stripe account. These may be bank accounts or cards.","items":{"anyOf":[{"$ref":"#/components/schemas/bank_account"},{"$ref":"#/components/schemas/card"}],"title":"Polymorphic","x-stripeBypassValidation":true},"type":"array"},"has_more":{"description":"True if this list has another page of items after this one that can be fetched.","type":"boolean"},"object":{"description":"String representing the object's type. Objects of the same type share the same value. Always has the value `list`.","enum":["list"],"type":"string"},"url":{"description":"The URL where this list can be accessed.","maxLength":5000,"type":"string"}},"required":["data","has_more","object","url"],"title":"ExternalAccountList","type":"object","x-expandableFields":["data"]},"future_requirements":{"$ref":"#/components/schemas/account_future_requirements"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"individual":{"$ref":"#/components/schemas/person"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["account"],"type":"string"},"payouts_enabled":{"description":"Whether Stripe can send payouts to this account.","type":"boolean"},"requirements":{"$ref":"#/components/schemas/account_requirements"},"settings":{"anyOf":[{"$ref":"#/components/schemas/account_settings"}],"description":"Options for customizing how the account functions within Stripe.","nullable":true},"tos_acceptance":{"$ref":"#/components/schemas/account_tos_acceptance"},"type":{"description":"The Stripe account type. Can be `standard`, `express`, or `custom`.","enum":["custom","express","standard"],"type":"string"}},"required":["id","object"],"title":"Account","type":"object","x-expandableFields":["business_profile","capabilities","company","controller","external_accounts","future_requirements","individual","requirements","settings","tos_acceptance"],"x-resourceId":"account"}