Skip to content
TriedDocs
Testing

List batch tests

List the 200 most recent batch tests, for all agents or for one agent.

GEThttps://api.tried.com.au/list-batch-tests

Returns batch tests, newest first, up to 200. Use it to track pass rates over time or to gate a CI step on the latest result.

Request#

Query parameters:

Field Type Required Description
agent_id string No Only batch tests for this agent.

Example request#

curl "https://api.tried.com.au/list-batch-tests?agent_id=agent_3e4f5a6b7c8d9e0f1a2b3c4d" \
  -H "Authorization: Bearer $TRIED_API_KEY"
const params = new URLSearchParams({ agent_id: "agent_3e4f5a6b7c8d9e0f1a2b3c4d" });
const res = await fetch(`https://api.tried.com.au/list-batch-tests?${params}`, {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const batchTests = await res.json();
import os, requests

res = requests.get(
    "https://api.tried.com.au/list-batch-tests",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    params={"agent_id": "agent_3e4f5a6b7c8d9e0f1a2b3c4d"},
)
batch_tests = res.json()

Response#

200 OK

An array of batch tests, ordered by creation time, newest first.

[
  {
    "batch_test_id": "batch_test_2c3d4e5f6a7b8c9d0e1f2a3b",
    "agent_id": "agent_3e4f5a6b7c8d9e0f1a2b3c4d",
    "status": "complete",
    "total_count": 2,
    "pass_count": 1,
    "fail_count": 1,
    "error_count": 0,
    "created_timestamp": 1760850000000,
    "completed_timestamp": 1760850084000
  }
]

The fields are described in Create batch test.

Errors#

Status When
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the agents scope.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Retell serves this list at GET /v2/list-batch-tests with response engine filters and pagination. Tried uses GET /list-batch-tests, filters by agent_id, and returns a plain array.