/v1/accounts/{account}/people/{person}Update a person associated with an account
Updates an existing person's information. All fields are optional — supply only the fields you want to change. This is a partial update; omitted fields retain their current values.
- IdempotentThe SDK sends
Idempotency-Key, so a retried request is only applied once.
The unique identifier of the account.
The unique identifier of the person to update.
Person fields to update. All fields are optional.
Details on the legal guardian's or authorizer's acceptance of the required Stripe agreements.
The person's address.
The Kana variation of the person's address (Japan only).
The Kanji variation of the person's address (Japan only).
The person's date of birth.
Documents that may be submitted to satisfy various informational requests.
The person's email address.
Specifies which fields in the response should be expanded.
The person's first name.
The Kana variation of the person's first name (Japan only).
The Kanji variation of the person's first name (Japan only).
A list of alternate names or aliases that the person is known by.
The person's gender (International regulations require either "male" or "female").
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.
The person's secondary ID number, as appropriate for their country, will be used for enhanced verification checks. In Thailand, this would be the laser code found on the back of an ID card. 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.
The person's last name.
The Kana variation of the person's last name (Japan only).
The Kanji variation of the person's last name (Japan only).
The person's maiden name.
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.
The country where the person is a national. Two-letter country code (ISO 3166-1 alpha-2), or "XX" if unavailable.
A person token, used to securely provide details to the person.
The person's phone number.
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.
The person's registered address.
The relationship that this person has with the account's legal entity.
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.
Demographic data related to the person.
The person's verification status.
The account the person is associated with.
Time at which the object was created. Measured in seconds since the Unix epoch.
The person's email address. Also available for accounts where controller.requirement_collection is stripe.
The person's first name. Also available for accounts where controller.requirement_collection is stripe.
The Kana variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
The Kanji variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
A list of alternate names or aliases that the person is known by. Also available for accounts where controller.requirement_collection is stripe.
The person's gender.
Unique identifier for the object.
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).
Whether the person's id_number_secondary was provided.
The person's last name. Also available for accounts where controller.requirement_collection is stripe.
The Kana variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
The Kanji variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
The person's maiden name.
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.
The country where the person is a national.
String representing the object's type. Objects of the same type share the same value.
The person's phone number.
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.
Whether the last four digits of the person's Social Security number have been provided (U.S. only).
Demographic data related to the person.
account and person must both identify existing resources. person must be a person associated with the specified account. When dob is provided, it must include day, month, and year as integers. first_name and last_name must not exceed 5000 characters.