curl -X GET 'https://api.elevenlabs.io/v1/convai/test-invocations?agent_id=agent-id&branch_id=branch-id&test_id=test-id&start_time=10&end_time=10&version_id=version-id&page_size=30&search=example-search&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

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

> List Test Invocations

## 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/test-invocations?agent_id=agent-id&branch_id=branch-id&test_id=test-id&start_time=10&end_time=10&version_id=version-id&page_size=30&search=example-search&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| agent_id | query | string | No | Filter by agent ID |
| branch_id | query | string | No | Filter by branch ID |
| test_id | query | string | No | Filter to invocations that include a... |
Other params: start_time, end_time, version_id, page_size, search, cursor

## Response (200 OK)
{"meta":{"total":0,"page":0},"results":[{}]}

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

GET

GET /v1/convai/test-invocations — ElevenLabs API

ElevenLabs API

List Test Invocations

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
→ 207 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/test-invocations?agent_id=agent-id&branch_id=branch-id&test_id=test-id&start_time=10&end_time=10&version_id=version-id&page_size=30&search=example-search&cursor=example-cursor' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Parameters

Name	In	Type	Required	Description
agent_id	query	string	No	Filter by agent ID
branch_id	query	string	No	Filter by branch ID
test_id	query	string	No	Filter to invocations that include a run of this test id
start_time	query	integer	No	Inclusive lower bound on created_at, in unix seconds
end_time	query	integer	No	Inclusive upper bound on created_at, in unix seconds
version_id	query	string	No	Filter by the agent version the tests ran against
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.
cursor	query	string	No	Used for fetching next page. Cursor is returned in the response.

Response 200 OK

{
  "meta": {
    "total": 0,
    "page": 0,
    "page_size": 0
  },
  "results": [
    {
      "id": "string",
      "agent_id": "string",
      "branch_id": "string",
      "version_id": "string",
      "ran_against_draft": false,
      "runs_diverged_from_version": false,
      "created_at_unix_secs": 0,
      "test_run_count": 0,
      "passed_count": 0,
      "failed_count": 0,
      "pending_count": 0,
      "cancelled_count": 0,
      "title": "string",
      "access_info": {
        "access_source": "creator",
        "creator_email": "[email protected]",
        "creator_name": "John Doe",
        "is_creator": true,
        "role": "admin"
      },
      "repeat_count": 1,
      "cancelled": false,
      "credits_used": 0,
      "total_price": 0
    }
  ],
  "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.