> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.resemble.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.resemble.ai/_mcp/server.

# List Identities

`GET https://app.resemble.ai/api/v2/identity`

Retrieve a paginated list of your team's identities, newest first.

## Query Parameters

| Parameter   | Type    | Required | Description                            |
| ----------- | ------- | -------- | -------------------------------------- |
| `page`      | integer | ❌        | Page number. Default: 1.               |
| `page_size` | integer | ❌        | Items per page (10–1000). Default: 10. |
| `search`    | string  | ❌        | Filter by identity name.               |

## Example Request

```bash
curl 'https://app.resemble.ai/api/v2/identity?search=John&page=1' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
```

## Response

```json
{
  "success": true,
  "page": 1,
  "num_pages": 5,
  "page_size": 10,
  "total_count": 50,
  "items": [
    {
      "uuid": "IDENTITY_UUID",
      "name": "John Doe",
      "created_at": "2026-01-01T00:00:00.000Z",
      "audio_url": "https://app.resemble.ai/rails/active_storage/blobs/...",
      "visibility": "team",
      "identity_type": "person",
      "notes": null,
      "voice_profile_id": null,
      "updated_at": "2026-01-01T00:00:00.000Z",
      "project_count": 2
    }
  ]
}
```

**Note:** Identities created before the multimodal upgrade may omit the `visibility`, `identity_type`, and related newer fields.