Persons

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

A platform can only access a subset of data in a person for an account where account.controller.requirement_collection is stripe, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.

See the Standard onboarding or Express onboarding documentation for information about prefilling information and account onboarding steps. Learn more about handling identity verification with the API.

Was this section helpful? Yes No

Create a person

POST / v1 / accounts /:id / persons

Update a person

POST / v1 / accounts /:id / persons /:id

Retrieve a person

GET / v1 / accounts /:id / persons /:id

List all persons

GET / v1 / accounts /:id / persons

Delete a person

DELETE / v1 / accounts /:id / persons /:id

The Person object

Attributes

id string Unique identifier for the object.
account string The account the person is associated with.
address nullable object The person’s address.
dob nullable object The person’s date of birth.
email nullable string The person’s email address. Also available for accounts where controller.requirement_collection is stripe.
first _ name nullable string The person’s first name. Also available for accounts where controller.requirement_collection is stripe.
last _ name nullable string The person’s last name. Also available for accounts where controller.requirement_collection is stripe.
metadata map Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
phone nullable string The person’s phone number.
relationship object Describes the person’s relationship to the account. Also available for accounts where controller.requirement_collection is stripe.
requirements nullable object Information about the requirements for this person, including what information needs to be collected, and by when.

More attributes

object string, value is "person"
additional _ tos _ acceptances object
address _ kana nullable object
address _ kanji nullable object
created timestamp
first _ name _ kana nullable string
first _ name _ kanji nullable string
full _ name _ aliases nullable array of strings
future _ requirements nullable object
gender nullable enum
id _ number _ provided boolean
id _ number _ secondary _ provided nullable boolean
last _ name _ kana nullable string
last _ name _ kanji nullable string
maiden _ name nullable string
nationality nullable string
political _ exposure nullable enum
registered _ address nullable object
ssn _ last _ 4 _ provided boolean
us _ cfpb _ data nullable object
verification object

Create a person

POST / v1 / accounts /:id / persons

Creates a new person.

Parameters

address object The person’s address.
dob object The person’s date of birth.
email string The person’s email address. The maximum length is 800 characters.
first _ name string The person’s first name.
id _ number string The person’s ID number, as appropriate for their country. For example, a social security number in the U.S., social insurance number in Canada, etc. Instead of the number itself, you can also provide a PII token provided by Stripe.js. Changing this value for the account’s representative requires that the account re-accept the terms of service.
last _ name string The person’s last name.
metadata map Set of key-value pairs 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.
phone string The person’s phone number.
relationship object The relationship that this person has with the account’s legal entity.
ssn _ last _ 4 string The last four digits of the person’s Social Security number (U.S. only). Changing this value for the account’s representative requires that the account re-accept the terms of service.

More parameters

additional _ tos _ acceptances object
address _ kana object
address _ kanji object
documents object
first _ name _ kana string
first _ name _ kanji string
full _ name _ aliases array of strings
gender enum
id _ number _ secondary string
last _ name _ kana string
last _ name _ kanji string
maiden _ name string
nationality string
person _ token string
political _ exposure enum
registered _ address object
us _ cfpb _ data object
verification object

Returns

Returns a person object.

Response

{ "id": "person_1N9XNb2eZvKYlo2CjPX7xF6F", "object": "person", "account": "acct_1032D82eZvKYlo2C", "created": 1684518375, "dob": { "day": null, "month": null, "year": null }, "first_name": "John", "future_requirements": { "alternatives": [], "currently_due": [], "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "id_number_provided": false, "last_name": "Doe", "metadata": {}, "relationship": { "director": false, "executive": false, "owner": false, "percent_ownership": null, "representative": false, "title": null }, "requirements": { "alternatives": [], "currently_due": [], "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "ssn_last_4_provided": false, "verification": { "additional_document": { "back": null, "details": null, "details_code": null, "front": null }, "details": null, "details_code": null, "document": { "back": null, "details": null, "details_code": null, "front": null }, "status": "unverified" }}