List Test Runs | Confident AI Docs

import requests
url = "https://api.confident-ai.com/v1/test-runs"
response = requests.get(url)
print(response.json())

{
  "success": true,
  "data": {
    "testRuns": [
      {
        "id": "342bd7a6",
        "createdAt": "2024-06-01T12:34:56Z",
        "identifier": "run042",
        "status": "COMPLETED",
        "multiTurn": false,
        "testsPassed": 8,
        "testsFailed": 2,
        "totalTests": 10,
        "metricsScores": [
          {
            "metric": "Answer Correctness",
            "scores": [
              0.9,
              1
            ],
            "passes": 8,
            "fails": 2,
            "errors": 0
          }
        ],
        "runDuration": 15.2,
        "evaluationCost": 0.254,
        "datasetAlias": "agent",
        "testFile": "test-file-1.jsonl",
        "summary": {}
      }
    ],
    "totalTestRuns": 113,
    "page": 1,
    "pageSize": 25
  }
}

Retrieves a paginated list of test runs for the authorized project. Results can be filtered and sorted by status, dates, conversational (multi-turn) or metrics. Pagination is controlled with page and pageSize. Filtering and sorting options include status, multiTurn, sortField, and ascending.

Query parameters

pageintegerOptional>=1Defaults to 1

Page number (must be a positive integer, default is 1).

pageSizeintegerOptional1-100Defaults to 25

Number of items per page (max 100, default is 25).

statusenumOptional

Filter test runs by status.

Allowed values:

multiTurnenumOptional

Filter for conversational (multi-turn) test runs only (“true” or “false”).

Allowed values:

sortFieldenumOptionalDefaults to created_at

Field to sort results by (“created_at” or “run_duration”).

Allowed values:

ascendingenumOptionalDefaults to false

Sort ascending (true) or descending (false).

Allowed values:

startstringOptionalformat: "datetime"

ISO 8601 start datetime filter (e.g. “2025-12-31T23:59:59Z”).

endstringOptionalformat: "datetime"

ISO 8601 end datetime filter (e.g. “2025-12-31T23:59:59Z”).

Response

A paginated list of test runs and total count.

successboolean

dataobject