# PostAccountPersonsPerson From **Stripe API**. `POST /v1/account/persons/{person}`

Updates an existing person.

## Parameters ### `person` - Location: path - Required: true - Type: `string` - maxLength: `5000` ## Request body - Required: false ### `application/x-www-form-urlencoded` - Type: `object` ```json {"additionalProperties":false,"properties":{"account":{"maxLength":5000,"type":"string"},"address":{"description":"The person's address.","properties":{"city":{"maxLength":100,"type":"string"},"country":{"maxLength":5000,"type":"string"},"line1":{"maxLength":200,"type":"string"},"line2":{"maxLength":200,"type":"string"},"postal_code":{"maxLength":5000,"type":"string"},"state":{"maxLength":5000,"type":"string"}},"title":"address_specs","type":"object"},"address_kana":{"description":"The Kana variation of the person's address (Japan only).","properties":{"city":{"maxLength":5000,"type":"string"},"country":{"maxLength":5000,"type":"string"},"line1":{"maxLength":5000,"type":"string"},"line2":{"maxLength":5000,"type":"string"},"postal_code":{"maxLength":5000,"type":"string"},"state":{"maxLength":5000,"type":"string"},"town":{"maxLength":5000,"type":"string"}},"title":"japan_address_kana_specs","type":"object"},"address_kanji":{"description":"The Kanji variation of the person's address (Japan only).","properties":{"city":{"maxLength":5000,"type":"string"},"country":{"maxLength":5000,"type":"string"},"line1":{"maxLength":5000,"type":"string"},"line2":{"maxLength":5000,"type":"string"},"postal_code":{"maxLength":5000,"type":"string"},"state":{"maxLength":5000,"type":"string"},"town":{"maxLength":5000,"type":"string"}},"title":"japan_address_kanji_specs","type":"object"},"dob":{"anyOf":[{"properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"],"title":"date_of_birth_specs","type":"object"},{"enum":[""],"type":"string"}],"description":"The person's date of birth."},"documents":{"description":"Documents that may be submitted to satisfy various informational requests.","properties":{"company_authorization":{"properties":{"files":{"items":{"maxLength":500,"type":"string"},"type":"array"}},"title":"documents_param","type":"object"},"passport":{"properties":{"files":{"items":{"maxLength":500,"type":"string"},"type":"array"}},"title":"documents_param","type":"object"},"visa":{"properties":{"files":{"items":{"maxLength":500,"type":"string"},"type":"array"}},"title":"documents_param","type":"object"}},"title":"person_documents_specs","type":"object"},"email":{"description":"The person's email address.","type":"string"},"expand":{"description":"Specifies which fields in the response should be expanded.","items":{"maxLength":5000,"type":"string"},"type":"array"},"first_name":{"description":"The person's first name.","maxLength":5000,"type":"string"},"first_name_kana":{"description":"The Kana variation of the person's first name (Japan only).","maxLength":5000,"type":"string"},"first_name_kanji":{"description":"The Kanji variation of the person's first name (Japan only).","maxLength":5000,"type":"string"},"full_name_aliases":{"anyOf":[{"items":{"maxLength":5000,"type":"string"},"type":"array"},{"enum":[""],"type":"string"}],"description":"A list of alternate names or aliases that the person is known by."},"gender":{"description":"The person's gender (International regulations require either \"male\" or \"female\").","type":"string"},"id_number":{"description":"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](https://stripe.com/docs/js/tokens_sources/create_token?type=pii).","maxLength":5000,"type":"string"},"last_name":{"description":"The person's last name.","maxLength":5000,"type":"string"},"last_name_kana":{"description":"The Kana variation of the person's last name (Japan only).","maxLength":5000,"type":"string"},"last_name_kanji":{"description":"The Kanji variation of the person's last name (Japan only).","maxLength":5000,"type":"string"},"maiden_name":{"description":"The person's maiden name.","maxLength":5000,"type":"string"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"enum":[""],"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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`."},"nationality":{"description":"The country where the person is a national. Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)), or \"XX\" if unavailable.","maxLength":5000,"type":"string"},"person_token":{"description":"A [person token](https://stripe.com/docs/connect/account-tokens), used to securely provide details to the person.","maxLength":5000,"type":"string"},"phone":{"description":"The person's phone number.","type":"string"},"political_exposure":{"description":"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.","maxLength":5000,"type":"string"},"relationship":{"description":"The relationship that this person has with the account's legal entity.","properties":{"director":{"type":"boolean"},"executive":{"type":"boolean"},"owner":{"type":"boolean"},"percent_ownership":{"anyOf":[{"type":"number"},{"enum":[""],"type":"string"}]},"representative":{"type":"boolean"},"title":{"maxLength":5000,"type":"string"}},"title":"relationship_specs","type":"object"},"ssn_last_4":{"description":"The last four digits of the person's Social Security number (U.S. only).","type":"string"},"verification":{"description":"The person's verification status.","properties":{"additional_document":{"properties":{"back":{"maxLength":500,"type":"string"},"front":{"maxLength":500,"type":"string"}},"title":"person_verification_document_specs","type":"object"},"document":{"properties":{"back":{"maxLength":500,"type":"string"},"front":{"maxLength":500,"type":"string"}},"title":"person_verification_document_specs","type":"object"}},"title":"person_verification_specs","type":"object"}},"type":"object"} ``` ## Security ### `basicAuth` - Type: `http` - Request header: `Authorization` - Scheme: `basic` Send credentials in the `Authorization` request header using the `Basic` scheme. Basic HTTP authentication. Allowed headers-- Authorization: Basic | Authorization: Basic ### `bearerAuth` - Type: `http` - Request header: `Authorization` - Scheme: `bearer` - Bearer format: `auth-scheme` Send the token in the `Authorization` request header using the `Bearer` scheme. Bearer HTTP authentication. Allowed headers-- Authorization: Bearer ## Responses ### `200` Successful response. ### `application/json` - 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). ```json {"description":"This is an object representing a person associated with a Stripe account.\n\nA 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.\nSee 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.\n\nRelated guide: [Handling Identity Verification with the API](https://stripe.com/docs/connect/identity-verification-api#person-information).","properties":{"account":{"description":"The account the person is associated with.","maxLength":5000,"type":"string"},"address":{"$ref":"#/components/schemas/address"},"address_kana":{"anyOf":[{"$ref":"#/components/schemas/legal_entity_japan_address"}],"nullable":true},"address_kanji":{"anyOf":[{"$ref":"#/components/schemas/legal_entity_japan_address"}],"nullable":true},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"dob":{"$ref":"#/components/schemas/legal_entity_dob"},"email":{"description":"The person's email address.","maxLength":5000,"nullable":true,"type":"string"},"first_name":{"description":"The person's first name.","maxLength":5000,"nullable":true,"type":"string"},"first_name_kana":{"description":"The Kana variation of the person's first name (Japan only).","maxLength":5000,"nullable":true,"type":"string"},"first_name_kanji":{"description":"The Kanji variation of the person's first name (Japan only).","maxLength":5000,"nullable":true,"type":"string"},"full_name_aliases":{"description":"A list of alternate names or aliases that the person is known by.","items":{"maxLength":5000,"type":"string"},"type":"array"},"future_requirements":{"anyOf":[{"$ref":"#/components/schemas/person_future_requirements"}],"nullable":true},"gender":{"description":"The person's gender (International regulations require either \"male\" or \"female\").","nullable":true,"type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"id_number_provided":{"description":"Whether the person's `id_number` was provided.","type":"boolean"},"last_name":{"description":"The person's last name.","maxLength":5000,"nullable":true,"type":"string"},"last_name_kana":{"description":"The Kana variation of the person's last name (Japan only).","maxLength":5000,"nullable":true,"type":"string"},"last_name_kanji":{"description":"The Kanji variation of the person's last name (Japan only).","maxLength":5000,"nullable":true,"type":"string"},"maiden_name":{"description":"The person's maiden name.","maxLength":5000,"nullable":true,"type":"string"},"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"},"nationality":{"description":"The country where the person is a national.","maxLength":5000,"nullable":true,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["person"],"type":"string"},"phone":{"description":"The person's phone number.","maxLength":5000,"nullable":true,"type":"string"},"political_exposure":{"description":"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.","enum":["existing","none"],"type":"string"},"relationship":{"$ref":"#/components/schemas/person_relationship"},"requirements":{"anyOf":[{"$ref":"#/components/schemas/person_requirements"}],"nullable":true},"ssn_last_4_provided":{"description":"Whether the last four digits of the person's Social Security number have been provided (U.S. only).","type":"boolean"},"verification":{"$ref":"#/components/schemas/legal_entity_person_verification"}},"required":["account","created","id","object"],"title":"Person","type":"object","x-expandableFields":["address","address_kana","address_kanji","dob","future_requirements","relationship","requirements","verification"],"x-resourceId":"person"} ``` ### `default` Error response. ### `application/json` - Type: `object` An error response from the Stripe API ```json {"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"} ``` ## Request examples ### cURL ```shell curl --request POST \ --url https://api.stripe.com/v1/account/persons/{person} \ --header 'content-type: application/x-www-form-urlencoded' \ --data '{ "account": "string", "address": { "city": "string", "country": "string", "line1": "string", "line2": "string", "postal_code": "string", "state": "string" }, "address_kana": { "city": "string", "country": "string", "line1": "string", "line2": "string", "postal_code": "string", "state": "string", "town": "string" }, "address_kanji": { "city": "string", "country": "string", "line1": "string", "line2": "string", "postal_code": "string", "state": "string", "town": "string" }, "dob": "string", "documents": { "company_authorization": { "files": [ "string" ] }, "passport": { "files": [ "string" ] }, "visa": { "files": [ "string" ] } }, "email": "string", "expand": [ "string" ], "first_name": "string", "first_name_kana": "string", "first_name_kanji": "string", "full_name_aliases": "string", "gender": "string", "id_number": "string", "last_name": "string", "last_name_kana": "string", "last_name_kanji": "string", "maiden_name": "string", "metadata": "string", "nationality": "string", "person_token": "string", "phone": "string", "political_exposure": "string", "relationship": { "director": true, "executive": true, "owner": true, "percent_ownership": "string", "representative": true, "title": "string" }, "ssn_last_4": "string", "verification": { "additional_document": { "back": "string", "front": "string" }, "document": { "back": "string", "front": "string" } } }' ```