# The Person object

### The Person object

```json
{
  "id": "person_test_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY",
  "object": "v2.core.account_person",
  "account": "acct_1Nv0FGQ9RKHgCVdK",
  "additional_addresses": [],
  "additional_names": [],
  "address": {
    "city": "Brothers",
    "country": "us",
    "line1": "27 Fredrick Ave",
    "postal_code": "97712",
    "state": "OR"
  },
  "created": "2024-11-26T17:10:07.000Z",
  "email": "jenny.rosen@example.com",
  "given_name": "Jenny",
  "id_numbers": [
    {
      "type": "us_ssn_last_4"
    }
  ],
  "metadata": {},
  "nationalities": [],
  "relationship": {
    "owner": true,
    "percent_ownership": "0.8",
    "representative": true,
    "title": "CEO"
  },
  "surname": "Rosen",
  "updated": "2024-11-26T17:10:07.000Z"
}
```

## Attributes

- `id` (string)
  Unique identifier for the Person.

- `object` (string, value is "v2.core.account_person")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `account` (string)
  The account ID which the individual belongs to.

- [`additional_addresses`](https://docs.stripe.com/api/v2/core/persons/object.md?query=additional_addresses) (array of objects, nullable)
  Additional addresses associated with the person.

- [`additional_names`](https://docs.stripe.com/api/v2/core/persons/object.md?query=additional_names) (array of objects, nullable)
  Additional names (e.g. aliases) associated with the person.

- [`additional_terms_of_service`](https://docs.stripe.com/api/v2/core/persons/object.md?query=additional_terms_of_service) (object, nullable)
  Attestations of accepted terms of service agreements.

- [`address`](https://docs.stripe.com/api/v2/core/persons/object.md?query=address) (object, nullable)
  The person’s residential address.

- `created` (timestamp)
  Time at which the object was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

- [`date_of_birth`](https://docs.stripe.com/api/v2/core/persons/object.md?query=date_of_birth) (object, nullable)
  The person’s date of birth.

- [`documents`](https://docs.stripe.com/api/v2/core/persons/object.md?query=documents) (object, nullable)
  Documents that may be submitted to satisfy various informational requests.

- `email` (string, nullable)
  The person’s email address.

- `given_name` (string, nullable)
  The person’s first name.

- [`id_numbers`](https://docs.stripe.com/api/v2/core/persons/object.md?query=id_numbers) (array of objects, nullable)
  The identification numbers (e.g., SSN) associated with the person.

- `legal_gender` (enum, nullable)
  The person’s gender (International regulations require either “male” or “female”).
Possible enum values:
  - `female`
    Female gender person.

  - `male`
    Male gender person.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `metadata` (map, nullable)
  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.

- `nationalities` (array of enums, nullable)
  The countries 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)).

- `phone` (string, nullable)
  The person’s phone number.

- `political_exposure` (enum, nullable)
  The person’s political exposure.
Possible enum values:
  - `existing`
    The person has disclosed that they do have political exposure.

  - `none`
    The person has disclosed that they have no political exposure.

- [`relationship`](https://docs.stripe.com/api/v2/core/persons/object.md?query=relationship) (object, nullable)
  The relationship that this person has with the Account’s business or legal entity.

- [`script_addresses`](https://docs.stripe.com/api/v2/core/persons/object.md?query=script_addresses) (object, nullable)
  The script addresses (e.g., non-Latin characters) associated with the person.

- [`script_names`](https://docs.stripe.com/api/v2/core/persons/object.md?query=script_names) (object, nullable)
  The script names (e.g. non-Latin characters) associated with the person.

- `surname` (string, nullable)
  The person’s last name.

- `updated` (timestamp)
  Time at which the object was last updated. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.