List test runs

List the 200 most recent test runs, filtered by batch test or test case.

GEThttps://api.tried.com.au/list-test-runs

Returns test runs, newest first, up to 200. Filter by batch test to see one batch, or by test case to see its history across batches. Transcripts are left out; read them with Get test run.

Request#

Query parameters:

Field	Type	Required	Description
`batch_test_id`	string	No	Only runs from this batch test.
`test_case_definition_id`	string	No	Only runs of this test case.

Example request#

curl "https://api.tried.com.au/list-test-runs?test_case_definition_id=test_case_8f7e6d5c4b3a29180f1e2d3c" \
  -H "Authorization: Bearer $TRIED_API_KEY"

const params = new URLSearchParams({ test_case_definition_id: "test_case_8f7e6d5c4b3a29180f1e2d3c" });
const res = await fetch(`https://api.tried.com.au/list-test-runs?${params}`, {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const runs = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/list-test-runs",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    params={"test_case_definition_id": "test_case_8f7e6d5c4b3a29180f1e2d3c"},
)
runs = res.json()

Response#

200 OK

An array of test runs, ordered by creation time, newest first.

[
  {
    "test_run_id": "test_run_5e6f7a8b9c0d1e2f3a4b5c6d",
    "batch_test_id": "batch_test_2c3d4e5f6a7b8c9d0e1f2a3b",
    "test_case_definition_id": "test_case_8f7e6d5c4b3a29180f1e2d3c",
    "test_case_name": "Reschedule appointment",
    "agent_id": "agent_3e4f5a6b7c8d9e0f1a2b3c4d",
    "status": "fail",
    "explanation": "Mock judge: required phrase not found in the transcript: \"thursday\".",
    "error": null,
    "duration_ms": 1830,
    "created_timestamp": 1760850000000,
    "completed_timestamp": 1760850001830
  }
]

The fields are described in Get test run.

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-test-runs/{test_case_batch_job_id} with pagination. Tried uses GET /list-test-runs with optional batch_test_id and test_case_definition_id query filters, and returns a plain array.