Safety & DetectionIdentity API

List Identities

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

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

Query Parameters

ParameterTypeRequiredDescription
pageinteger❌Page number. Default: 1.
page_sizeinteger❌Items per page (10–1000). Default: 10.
searchstring❌Filter by identity name.

Example Request

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

Response

1{
2  "success": true,
3  "page": 1,
4  "num_pages": 5,
5  "page_size": 10,
6  "total_count": 50,
7  "items": [
8    {
9      "uuid": "IDENTITY_UUID",
10      "name": "John Doe",
11      "created_at": "2026-01-01T00:00:00.000Z",
12      "audio_url": "https://app.resemble.ai/rails/active_storage/blobs/...",
13      "visibility": "team",
14      "identity_type": "person",
15      "notes": null,
16      "voice_profile_id": null,
17      "updated_at": "2026-01-01T00:00:00.000Z",
18      "project_count": 2
19    }
20  ]
21}

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