# account

From **Stripe API**.

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).

- Type: `object`

## Properties

### `business_profile`

- Required: false
- Nullable: true

Business information about the account.

### `business_type`

- Required: false
- Type: `string`
- Nullable: true
- Allowed values: `"company"`, `"government_entity"`, `"individual"`, `"non_profit"`

The business type.

### `capabilities`

- Required: false
- Type: `object`

### `charges_enabled`

- Required: false
- Type: `boolean`

Whether the account can create live charges.

### `company`

- Required: false
- Type: `object`

### `controller`

- Required: false
- Type: `object`

### `country`

- Required: false
- Type: `string`
- maxLength: `5000`

The account's country.

### `created`

- Required: false
- Type: `integer`
- Format: `unix-time`

Time at which the object was created. Measured in seconds since the Unix epoch.

### `default_currency`

- Required: false
- Type: `string`
- maxLength: `5000`

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).

### `details_submitted`

- Required: false
- Type: `boolean`

Whether account details have been submitted. Standard accounts cannot receive payouts before this is true.

### `email`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

An email address associated with the account. You can treat this as metadata: it is not used for authentication or messaging account holders.

### `external_accounts`

- Required: false
- Type: `object`

External accounts (bank accounts and debit cards) currently attached to this account

### `future_requirements`

- Required: false
- Type: `object`

### `id`

- Required: true
- Type: `string`
- maxLength: `5000`

Unique identifier for the object.

### `individual`

- Required: false
- Type: `object`

This is an object representing a person associated with a Stripe account.

A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account.
See the [Standard onboarding](https://stripe.com/docs/connect/standard-accounts) or [Express onboarding documentation](https://stripe.com/docs/connect/express-accounts) for information about platform pre-filling and account onboarding steps.

Related guide: [Handling Identity Verification with the API](https://stripe.com/docs/connect/identity-verification-api#person-information).

### `metadata`

- Required: false
- Type: `object`

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.

### `object`

- Required: true
- Type: `string`
- Allowed values: `"account"`

String representing the object's type. Objects of the same type share the same value.

### `payouts_enabled`

- Required: false
- Type: `boolean`

Whether Stripe can send payouts to this account.

### `requirements`

- Required: false
- Type: `object`

### `settings`

- Required: false
- Nullable: true

Options for customizing how the account functions within Stripe.

### `tos_acceptance`

- Required: false
- Type: `object`

### `type`

- Required: false
- Type: `string`
- Allowed values: `"custom"`, `"express"`, `"standard"`

The Stripe account type. Can be `standard`, `express`, or `custom`.

## JSON Schema

```json
{"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"}
```
