List users | ElevenLabs Documentation

Get distinct users from conversations with pagination.

agent_idstring or nullOptional

The id of the agent you're taking the action on.

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_987654321",
5	"last_contact_unix_secs": 1685606400,
6	"first_contact_unix_secs": 1677628800,
7	"conversation_count": 15,
8	"last_contact_conversation_id": "conv_1234567890abcdef",
9	"last_contact_agent_id": "21m00Tcm4TlvDq8ikWAM",
10	"last_contact_agent_name": "Agent Smith"
11	}
12	],
13	"has_more": true,
14	"next_cursor": "eyJwYWdlIjoxfQ=="
15	}

1	curl https://api.elevenlabs.io/v1/convai/users \
2	-H "xi-api-key: xi-api-key" \
3	-H "Content-Type: application/json"