List Test Runs

GEThttps://api.confident-ai.com/v1/test-runs

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.

GET/v1/test-runs

curl -X GET "https://api.confident-ai.com/v1/test-runs" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"

200

{
  "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": "8/10 passed"
      }
    ],
    "totalTestRuns": 113,
    "page": 1,
    "pageSize": 25
  }
}

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Query parameters

pageintegerdefault: 1
Page number (must be a positive integer, default is 1).
pageSizeintegerdefault: 25
Number of items per page (max 100, default is 25).
statusenum
Filter test runs by status.
multiTurnenum
Filter for conversational (multi-turn) test runs only ("true" or "false").
sortByenumdefault: createdAt
Field to sort results by ("createdAt" or "runDuration").
ascendingenum
This determines if the field specified in sortBy should be in ascending order. Defaults to false.
startstring
ISO 8601 start datetime filter (e.g. "2025-12-31T23:59:59Z").
endstring
ISO 8601 end datetime filter (e.g. "2025-12-31T23:59:59Z").

Response

A paginated list of test runs and total count.

successboolean
dataobject
Show 4 propertiesHide 4 properties
- testRunslist of objects
  Show 14 propertiesHide 14 properties
  - idstring
    Test run unique identifier.
  - createdAtstring
  - identifierstring
    Optional test run identifier.
  - statusenum
    Show 4 enum valuesHide 4 enum values
    COMPLETED
    ERRORED
    IN_PROGRESS
    CANCELLED
  - multiTurnboolean
    Whether the test run is conversational.
  - testsPassedinteger
  - testsFailedinteger
  - totalTestsinteger
  - metricsScoreslist of objects
    Show 5 propertiesHide 5 properties
    metricstring
    scoreslist of numbers
    passesinteger
    failsinteger
    errorsinteger
  - runDurationnumber
  - evaluationCostnumber
  - datasetAliasstring
  - testFilestring
  - summaryobject
    Show 2 propertiesHide 2 properties
    topicSummarieslist of objects
    Show 3 propertiesHide 3 properties
    topicstring
    testCaseIdslist of integer | string
    Show 2 variantsHide 2 variants
    integer
    OR
    string
    summaryPointslist of objects
    Show 3 propertiesHide 3 properties
    gradenumber
    contentstring
    testCaseIdslist of integer | string
    summaryOverviewobject
    Show 2 propertiesHide 2 properties
    summarylist of strings
    actionItemslist of strings
- totalTestRunsinteger
  Total number of test runs matching filters.
- pageinteger
  Current page number.
- pageSizeinteger
  Page size.

Built byConfident AI