Skip to main content
Manja / Stripe
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

Person

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 …

account string
required

The account the person is associated with.

maxLength:5000

address_kana
optionalnullable
address_kanji
optionalnullable
created integer (unix-time)
required

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

email string
optionalnullable

The person's email address.

maxLength:5000

first_name string
optionalnullable

The person's first name.

maxLength:5000

first_name_kana string
optionalnullable

The Kana variation of the person's first name (Japan only).

maxLength:5000

first_name_kanji string
optionalnullable

The Kanji variation of the person's first name (Japan only).

maxLength:5000

full_name_aliases array
optional

A list of alternate names or aliases that the person is known by.

future_requirements
optionalnullable
gender string
optionalnullable

The person's gender (International regulations require either "male" or "female").

id string
required

Unique identifier for the object.

maxLength:5000

id_number_provided boolean
optional

Whether the person's `id_number` was provided.

last_name string
optionalnullable

The person's last name.

maxLength:5000

last_name_kana string
optionalnullable

The Kana variation of the person's last name (Japan only).

maxLength:5000

last_name_kanji string
optionalnullable

The Kanji variation of the person's last name (Japan only).

maxLength:5000

maiden_name string
optionalnullable

The person's maiden name.

maxLength:5000

metadata object
optional

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.

nationality string
optionalnullable

The country where the person is a national.

maxLength:5000

object string
required

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

Allowed: "person"

phone string
optionalnullable

The person's phone number.

maxLength:5000

political_exposure string
optional

Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.

Allowed: "existing""none"

requirements
optionalnullable
ssn_last_4_provided boolean
optional

Whether the last four digits of the person's Social Security number have been provided (U.S. only).