Skip to main content
GET
/
v2
/
list-batch-tests
cURL
curl --request GET \
  --url https://api.retellai.com/v2/list-batch-tests \
  --header 'Authorization: Bearer <token>'
{
  "pagination_key": "<string>",
  "has_more": true,
  "items": [
    {
      "test_case_batch_job_id": "<string>",
      "status": "in_progress",
      "response_engine": {
        "type": "retell-llm",
        "llm_id": "<string>",
        "version": 0
      },
      "pass_count": 1,
      "fail_count": 1,
      "error_count": 1,
      "total_count": 1,
      "creation_timestamp": 123,
      "user_modified_timestamp": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.retellai.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Query Parameters

type
enum<string>
required

Type of response engine

Available options:
retell-llm,
conversation-flow
llm_id
string

LLM ID (required when type is retell-llm)

conversation_flow_id
string

Conversation flow ID (required when type is conversation-flow)

version
integer

Version of the response engine (defaults to latest)

limit
integer
default:50

Maximum number of items to return.

Required range: x <= 1000
pagination_key
string

Pagination key for fetching the next page.

Response

Batch test jobs retrieved successfully

pagination_key
string

Pagination key for the next page.

has_more
boolean

Whether more results are available.

items
object[]