Sample - Stripe API
GET/v1/accounts/{account}/people/{person}

Retrieve a person

Retrieves a person associated with an account's legal entity. Provide both account and person to identify the account-person relationship, and optionally use expand for additional response fields. The response contains the person's account, identifier, creation time, and available legal-entity information.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
accountstringrequired
The account associated with the person. Maximum 5000 characters.
personstringrequired
The unique identifier of the person to retrieve. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the returned person object. Each value must be no longer than 5000 characters.

2 status codes
200Returns the requested person object, including its account, unique identifier, creation time, object type, and available legal-entity information.
accountstringrequired
The account the person is associated with.
additional_tos_acceptancesobjectoptional
addressobjectoptional
address_kanaobjectoptional
address_kanjiobjectoptional
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
dobobjectoptional
emailstringoptional
The person's email address. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
first_namestringoptional
The person's first name. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
first_name_kanastringoptional
The Kana variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
first_name_kanjistringoptional
The Kanji variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
full_name_aliasesarray<string>optional
A list of alternate names or aliases that the person is known by. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
future_requirementsobjectoptional
genderstringoptional
The person's gender.
idstringrequired
Unique identifier for the object.
id_number_providedbooleanoptional
Whether the person's `id_number` was provided. True if either the full ID number was provided or if only the required part of the ID number was provided (ex. last four of an individual's SSN for the US indicated by `ssn_last_4_provided`).
id_number_secondary_providedbooleanoptional
Whether the person's `id_number_secondary` was provided.
last_namestringoptional
The person's last name. Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
last_name_kanastringoptional
The Kana variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
last_name_kanjistringoptional
The Kanji variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
maiden_namestringoptional
The person's maiden name.
metadataobjectoptional
Set 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.
nationalitystringoptional
The country where the person is a national.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:person
phonestringoptional
The person's phone number.
political_exposurestringoptional
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:existingnone
registered_addressobjectoptional
relationshipobjectoptional
requirementsobjectoptional
ssn_last_4_providedbooleanoptional
Whether the last four digits of the person's Social Security number have been provided (U.S. only).
us_cfpb_dataobjectoptional
Demographic data related to the person.
verificationobjectoptional
defaultReturned when the request cannot be processed; the response contains an API error object with an error type and related details.
errorobjectrequired

Error handling

account and person must identify the account-person relationship to retrieve, and each value must not exceed 5000 characters. Each expand value must also be no longer than 5000 characters.