List tests | ElevenLabs Documentation

Lists all agent response tests with pagination support and optional search filtering.

cursorstring or nullOptional

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

page_sizeintegerOptional1-100Defaults to 30

How many Tests to return at maximum. Can not exceed 100, defaults to 30.

searchstring or nullOptional

Search query to filter tests by name.

parent_folder_idstring or nullOptional

Filter by parent folder ID. Use 'root' to get items in the root folder.

typeslist of enums or nullOptional

If present, the endpoint will return only tests/folders of the given types.

Allowed values:

include_foldersboolean or nullOptionalDeprecated

Deprecated. Use the types query param and include folder instead.

sort_modeenumOptionalDefaults to default

Sort mode for listing tests. Use ‘folders_first’ to place folders before tests.

Allowed values:

Successful Response

testslist of objects

has_moreboolean

next_cursorstring or null

422

Unprocessable Entity Error

1	{
2	"tests": [
3	{
4	"id": "string",
5	"name": "string",
6	"created_at_unix_secs": 1,
7	"last_updated_at_unix_secs": 1,
8	"type": "llm",
9	"access_info": {
10	"is_creator": true,
11	"creator_name": "John Doe",
12	"creator_email": "john.doe@example.com",
13	"role": "admin"
14	},
15	"entity_type": "test",
16	"folder_parent_id": "string",
17	"folder_path": [
18	{
19	"id": "string",
20	"name": ""
21	}
22	],
23	"children_count": 1
24	}
25	],
26	"has_more": true,
27	"next_cursor": "string"
28	}

1	curl https://api.elevenlabs.io/v1/convai/agent-testing \
2	-H "xi-api-key: xi-api-key"