> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Identity object

> View information and details about the user's identity.

Identity includes details about the user's personal identifiable information, such as the user's name, address, contact information, and other information. The information about the user is connected to the `link_id` of Truv's product types.

## Attributes

The values in the table below cover attributes for identity.

| Attribute        | Type         | Description                                                   |
| :--------------- | :----------- | :------------------------------------------------------------ |
| id               | string       | Unique user ID                                                |
| created\_at      | string       | ISO 8601 value for first time retrieving user's identity info |
| updated\_at      | string       | ISO 8601 value for last time retrieving user's identity info  |
| first\_name      | string       | First name                                                    |
| last\_name       | string       | Last name                                                     |
| full\_name       | string       | Full name                                                     |
| middle\_initials | string, null | Middle initials                                               |
| email            | string, null | Email address                                                 |
| `ssn`            | string       | Social Security Number, full or last 4 digits                 |
| date\_of\_birth  | date, null   | Date of birth                                                 |
| home\_address    | object       | [Address object](#address-object)                             |

### Address object

The values in this table are for the address object of the user.

| Attribute | Type   | Description |
| :-------- | :----- | :---------- |
| street    | string | Street      |
| city      | string | City        |
| state     | string | State       |
| zip       | string | Zip         |
| country   | string | Country     |

***

## Endpoint

The item below is the available endpoint for Identity.

* [Retrieve an identity](/api-reference/identity/link-identity)

***

## Example response

The response below is the JSON object for the endpoint.

```json theme={null}
{
  "id": "710097b33ec14f898df3644b563430e1",
  "created_at": "2022-08-10T09:30:48.520089Z",
  "updated_at": "2022-08-10T09:30:48.520114Z",
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "middle_initials": null,
  "email": "john.doe@gmail.com",
  "ssn": "221122112",
  "date_of_birth": "1992-03-03",
  "home_address": {
    "zip": "94062",
    "city": "Redwood City",
    "state": "CA",
    "street": "35 Dry Ridge Rd",
    "country": "US"
  }
}
```
