---
title: "List assistant tests with pagination"
method: GET
path: "/ai/assistants/tests"
tags: ["Assistants"]
---

# List assistant tests with pagination

`GET /ai/assistants/tests`

Retrieves a paginated list of assistant tests with optional filtering capabilities

## Query parameters

- `test_suite` string — Filter tests by test suite name
- `telnyx_conversation_channel` string — Filter tests by communication channel (e.g., 'web_chat', 'sms')
- `destination` string — Filter tests by destination (phone number, webhook URL, etc.)
- `page` object
  - `number` integer — Page number to retrieve (1-based indexing)
  - `size` integer — Number of tests to return per page (1-100)

## Response `200`

Returns paginated test list with metadata for navigation and filtering

- PaginatedAssistantTestList — Paginated list of assistant tests with metadata. Returns a subset of tests based on pagination parameters along with metadata for implementing pagination controls in the UI.
  - `data` AssistantTestResponse[], required — Array of assistant test objects for the current page.
    - `created_at` string, date-time, required — Timestamp when the test was created.
    - `description` string — Detailed description of the test's purpose and scope.
    - `destination` string — Target destination for test conversations.
    - `instructions` string — Detailed test scenario instructions and objectives.
    - `max_duration_seconds` integer — Maximum allowed duration for test execution in seconds.
    - `name` string, required — Human-readable name of the test.
    - `rubric` object[], required — Evaluation criteria used to assess test performance.
      - `criteria` string, required — Specific guidance on how to assess the assistant’s performance for this rubric item.
      - `name` string, required — Label for the evaluation criterion, e.g., Empathy, Accuracy, Clarity.
    - `telnyx_conversation_channel` 'phone_call' | 'web_call' | 'sms_chat' | 'web_chat', required
    - `test_id` string, uuid, required — Unique identifier for the assistant test.
    - `test_suite` string — Test suite grouping for organizational purposes.
  - `meta` Meta, required
    - `page_number` integer, required
    - `page_size` integer, required
    - `total_pages` integer, required
    - `total_results` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)