---
title: "List test run results"
method: GET
path: "/ai/tests/test_framework/v1/results"
tags: ["AI Tests"]
---

# List test run results

`GET /ai/tests/test_framework/v1/results`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/tests/test_framework/v1/results`
- Auth: HTTP bearer

Returns a paginated list of test run batches in your organization, optionally filtered by test agent, search text, or scenarios.

## Query parameters

- `page` integer
- `page_size` integer
- `agent_id` integer
- `search` string
- `scenarios` string

## Response `200`

Paginated list of test run batches.

- TestRunResultListResponse
  - `count` integer
  - `next` string, uri, nullable, required
  - `previous` string, uri, nullable, required
  - `results` TestRunResultSummary[], required
    - `id` integer, required
    - `name` string, required
    - `agent` integer, required
    - `agent_name` string
    - `agent_inbound` boolean
    - `status` string, required: Run batch status: running, completed, failed, pending, in_progress, evaluating, in_queue, timeout, cancelled, or scaling_up.
    - `success_rate` union: Share of runs judged successful.
      - number
      - string
    - `run_as_text` boolean: Whether the batch ran as text chat rather than voice calls.
    - `is_cronjob` boolean: Whether this batch was started by a scheduled job.
    - `runs` object[], nullable: Run summaries in this batch. Retrieve the batch for detail keyed by run ID.
      - `id` integer
      - `status` string
      - `scenario` integer
      - `scenario_name` string
      - `number` string, nullable
      - `inbound_number` string, nullable
    - `met_expected_outcome_count` union
      - integer
      - string
    - `total_expected_outcome_count` union
      - integer
      - string
    - `total_runs_count` union
      - integer
      - string
    - `completed_runs_count` union
      - integer
      - string
    - `success_runs_count` union
      - integer
      - string
    - `failed_runs_count` union
      - integer
      - string
    - `scenarios` object[], nullable
      - `id` integer
      - `name` string
    - `run_type` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Bad Request. The AI Tests service rejected the request.
- `401`: Unauthorized. Missing or invalid API key.
- `404`: Not Found. The requested resource does not exist or is not enabled for your account.
- `422`: Unprocessable Entity. A validation error occurred.
- `429`: Too Many Requests. The AI Tests service rate-limited the request.
- `503`: Service Unavailable. The AI Tests service is unavailable.

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-22** `09b2e45a88da`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/tests/test_framework/v1/results/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)