curl -X GET 'https://api.elevenlabs.io/v1/convai/agent-testing?cursor=example-cursor&page_size=30&search=example-search&parent_folder_id=parent-folder-id&types=example&include_folders=true&sort_mode=default&sharing_mode=all&created_by_user_id=created-by-user-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/convai/agent-testing (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> List Agent Response Tests

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/convai/agent-testing?cursor=example-cursor&page_size=30&search=example-search&parent_folder_id=parent-folder-id&types=example&include_folders=true&sort_mode=default&sharing_mode=all&created_by_user_id=created-by-user-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| cursor | query | string | No | Used for fetching next page. Cursor i... |
| page_size | query | integer | No | How many Tests to return at maximum.... |
| search | query | string | No | Search query to filter tests and fold... |
Other params: parent_folder_id, types, include_folders, sort_mode, sharing_mode, created_by_user_id

## Response (200 OK)
{"tests":[{}],"next_cursor":"string"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

GET /v1/convai/agent-testing — ElevenLabs API

ElevenLabs API

List Agent Response Tests

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/convai/agent-testing?cursor=example-cursor&page_size=30&search=example-search&parent_folder_id=parent-folder-id&types=example&include_folders=true&sort_mode=default&sharing_mode=all&created_by_user_id=created-by-user-id' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Parameters

Name	In	Type	Required	Description
cursor	query	string	No	Used for fetching next page. Cursor is returned in the response.
page_size	query	integer	No	How many Tests to return at maximum. Can not exceed 100, defaults to 30.
search	query	string	No	Search query to filter tests and folders by name.
parent_folder_id	query	string	No	Filter by parent folder ID. Use 'root' to get items in the root folder.
types	query	string[]	No	If present, the endpoint will return only tests/folders of the given types.
include_folders	query	boolean	No	Deprecated. Use the `types` query param and include `folder` instead.
sort_mode	query	string	No	Sort mode for listing tests. Use 'folders_first' to place folders before tests.
sharing_mode	query	string	No	Filter test visibility. Use `shared_with_me` to return only tests/folders shared with the current user that they did not create.
created_by_user_id	query	string	No	Filter tests and folders by creator user ID. Use '@me' to refer to the authenticated user.

Response 200 OK

{
  "tests": [
    {
      "id": "string",
      "name": "string",
      "access_info": {
        "access_source": "creator",
        "creator_email": "[email protected]",
        "creator_name": "John Doe",
        "is_creator": true,
        "role": "admin"
      },
      "created_at_unix_secs": 0,
      "last_updated_at_unix_secs": 0,
      "type": "llm",
      "entity_type": "test",
      "folder_parent_id": "string",
      "folder_path": [
        {
          "id": "string",
          "name": ""
        }
      ],
      "children_count": 0,
      "conversation_initiation_source": "unknown"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.