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

# The identities endpoint

The identities endpoint is used to retrieve the underlying identity (PII) of an Entity. The Identity endpoint requires an Entity to have at least a phone number.

For an active entity or entities with a matched identity (`verification.identity.matched`) the identity endpoint will return a single identity with the PII.

For all other entities the identity endpoint could return multiple identities as the provided PII was not enough to
disambiguate and match a single identity.

> [!WARNING]
>
> The Identity endpoint is restricted to most teams. Contact your Method CSM for more information.

**The Identity endpoint is available as a:**

| Type | Use-Case |
| - | - |
| `Product` | Retrieve the full Identity (PII) for any Entity |

## Identity Objects

```json THE IDENTITY OBJECT theme={null}
{
  "id": "idn_NhTRUVEknYaFM",
  "entity_id": "ent_au22b1fbFJbp8",
  "status": "completed",
  "identities": [
    {
      "first_name": "KEVIN",
      "last_name": "DOYLE",
      "dob": "1997-03-18",
      "ssn": "111223333",
      "phone": "+16505551115",
      "address": {
        "address": "3300 N INTERSTATE 35",
        "city": "AUSTIN",
        "postal_code": "78705",
        "state": "TX"
      }
    },
    {
      "first_name": "JOE",
      "last_name": "DOYLE",
      "dob": "1997-03-18",
      "ssn": "123456789",
      "phone": "+16505551115",
      "address": {
        "address": "3300 N INTERSTATE 35",
        "city": "AUSTIN",
        "postal_code": "78705",
        "state": "TX"
      }
    }
  ],
  "error": null,
  "created_at": "2024-01-16T19:36:08.263Z",
  "updated_at": "2024-01-16T19:36:08.263Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.