---
title: "List Identities"
method: GET
path: "/v1/identities/"
tags: ["identities", "identities"]
---

# List Identities

`GET /v1/identities/`

Get a list of all identities in the database

## Query parameters

- `name` string, nullable
- `project_id` string, nullable
- `identifier_key` string, nullable
- `identity_type` 'org' | 'user' | 'other' — Enum to represent the type of the identity.
- `before` string, nullable — Identity ID cursor for pagination. Returns identities that come before this identity ID in the specified sort order
- `after` string, nullable — Identity ID cursor for pagination. Returns identities that come after this identity ID in the specified sort order
- `limit` integer, nullable — Maximum number of identities to return
- `order` 'asc' | 'desc' — Sort order for identities by creation time. 'asc' for oldest first, 'desc' for newest first
- `order_by` 'created_at' — Field to sort by

## Response `200`

Successful Response

- Identity[]
  - `id` string — The human-friendly ID of the Identity
  - `identifier_key` string, required — External, user-generated identifier key of the identity.
  - `name` string, required — The name of the identity.
  - `identity_type` 'org' | 'user' | 'other', required — Enum to represent the type of the identity.
  - `project_id` string, nullable — The project id of the identity, if applicable.
  - `agent_ids` string[], required — The IDs of the agents associated with the identity.
  - `block_ids` string[], required — The IDs of the blocks associated with the identity.
  - `properties` IdentityProperty[] — List of properties associated with the identity
    - `key` string, required — The key of the property
    - `value` union, required — The value of the property
      - string
      - integer
      - number
      - boolean
      - object
    - `type` 'string' | 'number' | 'boolean' | 'json', required — Enum to represent the type of the identity property.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.dev/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yu-code666/letta-api/revisions/6cec99480c13/schema)