List users

Get distinct users from conversations with pagination.

agent_idstringOptional

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

call_start_before_unixintegerOptional

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

call_start_after_unixintegerOptional

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

searchstringOptional

Search/filter by user ID (exact match).

page_sizeintegerOptional1-100Defaults to 30

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

cursorstringOptional

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

Successful Response

userslist of objects

has_moreboolean

next_cursorstring or null

1	from elevenlabs import ElevenLabs
2	from elevenlabs.environment import ElevenLabsEnvironment
3
4	client = ElevenLabs(
5	environment=ElevenLabsEnvironment.PRODUCTION
6	)
7
8	client.conversational_ai.users.list(
9	agent_id="21m00Tcm4TlvDq8ikWAM",
10	call_start_before_unix=1700000000,
11	call_start_after_unix=1600000000,
12	search="user_12345",
13	page_size=25,
14	cursor="eyJwYWdlIjoxfQ=="
15	)

1	{
2	"users": [
3	{
4	"user_id": "user_12345",
5	"last_contact_unix_secs": 1699999999,
6	"first_contact_unix_secs": 1600001234,
7	"conversation_count": 42,
8	"last_agent_id": "21m00Tcm4TlvDq8ikWAM",
9	"last_agent_name": "SupportBot Alpha"
10	}
11	],
12	"has_more": true,
13	"next_cursor": "eyJwYWdlIjoyfQ=="
14	}