List users | ElevenLabs Documentation

Get distinct users from conversations with pagination.

agent_idstring or nullOptional

Agent id (agent_…) or speech engine external id (seng_), resolved to the same underlying resource.

branch_idstring or nullOptional

Filter conversations by branch ID.

call_start_before_unixinteger or nullOptional

Unix timestamp (in seconds) to filter conversations up to this start date.

call_start_after_unixinteger or nullOptional

Unix timestamp (in seconds) to filter conversations after to this start date.

searchstring or nullOptional

Search/filter by user ID (exact match).

page_sizeintegerOptional1-100Defaults to 30

How many users to return at maximum. Defaults to 30.

sort_byenumOptional

The field to sort the results by. Defaults to last_contact_unix_secs.

Allowed values:

cursorstring or nullOptional

Used for fetching next page. Cursor is returned in the response.

Successful Response

userslist of objects

has_moreboolean

next_cursorstring or null

422

Unprocessable Entity Error

1	{
2	"users": [
3	{
4	"user_id": "user_9f8b7c6d5e4a3b2c1d0e",
5	"last_contact_unix_secs": 1685404800,
6	"first_contact_unix_secs": 1677628800,
7	"conversation_count": 42,
8	"last_contact_conversation_id": "conv_5a6b7c8d9e0f1a2b3c4d",
9	"last_contact_agent_id": "agent_3701k3ttaq12ewp8b7qv5rfyszkz",
10	"last_contact_agent_name": "SupportBot Alpha"
11	}
12	],
13	"has_more": true,
14	"next_cursor": "eyJwYWdlIjoxfQ=="
15	}

$	curl https://api.elevenlabs.io/v1/convai/users \
>	-H "Content-Type: application/json"