---
title: "List Identities"
method: GET
path: "/api/v2/users/{user_id}/identities"
tags: ["User Identities"]
---

# List Identities

`GET /api/v2/users/{user_id}/identities`

Returns a list of identities for the given user.

Use the first endpoint if authenticating as an agent. Use the second if authenticating as an end user. End users can only list email and phone number identities.

#### Pagination

* Cursor pagination (recommended)
* Offset pagination

See [Pagination](/api-reference/introduction/pagination/).

Returns a maximum of 100 records per page for cursor pagination.

#### Allowed For

* Agents
* Verified end users

## Query parameters

- `page[before]` string
- `page[after]` string
- `page[size]` integer

## Response `200`

Success response

- UserIdentitiesResponse
  - `identities` UserIdentityObject[]
    - `created_at` string, date-time — The time the identity was created
    - `deliverable_state` string — Email identity type only. Indicates if Zendesk sends notifications to the email address. See [Deliverable state](#deliverable-state)
    - `id` integer — Automatically assigned on creation
    - `primary` boolean — If the identity is the primary identity. *Writable only when creating, not when updating. Use the [Make Identity Primary](#make-identity-primary) endpoint instead
    - `type` 'email' | 'twitter' | 'facebook' | 'google' | 'phone_number' | 'agent_forwarding' | 'any_channel' | 'foreign' | 'sdk', required — The type of this identity
    - `undeliverable_count` integer — The number of times a soft-bounce response was received at that address
    - `updated_at` string, date-time — The time the identity was updated
    - `url` string — The API url of this identity
    - `user_id` integer, required — The id of the user
    - `value` string, required — The identifier for this identity, such as an email address
    - `verification_method` 'none' | 'low' | 'sso' | 'embed' | 'full' — Indicates the state of user identity verification. See [Verification method](#verification-method).
    - `verified` boolean — If the identity has been verified. Deprecated. Use `verification_method` as a more accurate representation of a user's state of verification.
    - `verified_at` string, date-time, nullable — The last time a full verification flow was completed for the identity

## Changes

> 29 revisions in range; 1 not diffed.

- **2025-06-12** `edbf399da815` — 3 info
  - added the new optional `query` request parameter `page[after]`
  - added the new optional `query` request parameter `page[before]`
  - added the new optional `query` request parameter `page[size]`

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/users/:user_id/identities/get.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)