> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # List assistant tests with pagination > Retrieves a paginated list of assistant tests with optional filtering capabilities ## OpenAPI ````yaml https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/ai/assistants.yml get /ai/assistants/tests openapi: 3.1.0 info: title: Telnyx AI Assistants API version: 2.0.0 description: >- API for managing AI Assistants, including CRUD fields, versions, tags, integrations, MCP servers, and shared tools. contact: email: support@telnyx.com servers: - url: https://api.telnyx.com/v2 security: - bearerAuth: [] paths: /ai/assistants/tests: get: tags: - Assistants summary: List assistant tests with pagination description: >- Retrieves a paginated list of assistant tests with optional filtering capabilities operationId: get_assistant_tests_public_assistants_tests_get parameters: - name: test_suite in: query required: false schema: type: string description: Filter tests by test suite name title: Test Suite description: Filter tests by test suite name - name: telnyx_conversation_channel in: query required: false schema: type: string description: Filter tests by communication channel (e.g., 'web_chat', 'sms') title: Telnyx Conversation Channel description: Filter tests by communication channel (e.g., 'web_chat', 'sms') - name: destination in: query required: false schema: type: string description: Filter tests by destination (phone number, webhook URL, etc.) title: Destination description: Filter tests by destination (phone number, webhook URL, etc.) - name: page in: query style: deepObject explode: true description: >- Consolidated page parameter (deepObject style). Originally: page[size], page[number] schema: type: object properties: size: type: integer maximum: 100 minimum: 1 description: Number of tests to return per page (1-100) default: 20 title: Page[Size] number: type: integer minimum: 1 description: Page number to retrieve (1-based indexing) default: 1 title: Page[Number] responses: '200': description: >- Returns paginated test list with metadata for navigation and filtering content: application/json: schema: $ref: '#/components/schemas/PaginatedAssistantTestList' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' x-codeSamples: - lang: JavaScript source: >- import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const assistantTest of client.ai.assistants.tests.list()) { console.log(assistantTest.test_id); } - lang: Python source: |- import os from telnyx import Telnyx client = Telnyx( api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted ) page = client.ai.assistants.tests.list() page = page.data[0] print(page.test_id) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tpage, err := client.AI.Assistants.Tests.List(context.TODO(), telnyx.AIAssistantTestListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n" - lang: Java source: |- package com.telnyx.sdk.example; import com.telnyx.sdk.client.TelnyxClient; import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient; import com.telnyx.sdk.models.ai.assistants.tests.TestListPage; import com.telnyx.sdk.models.ai.assistants.tests.TestListParams; public final class Main { private Main() {} public static void main(String[] args) { TelnyxClient client = TelnyxOkHttpClient.fromEnv(); TestListPage page = client.ai().assistants().tests().list(); } } - lang: Ruby source: |- require "telnyx" telnyx = Telnyx::Client.new(api_key: "My API Key") page = telnyx.ai.assistants.tests.list puts(page) - lang: CLI source: |- telnyx ai:assistants:tests list \ --api-key 'My API Key' components: schemas: PaginatedAssistantTestList: properties: meta: allOf: - $ref: '#/components/schemas/Meta' description: Pagination metadata including total counts and current page info. data: items: $ref: '#/components/schemas/AssistantTestResponse' type: array title: Data description: Array of assistant test objects for the current page. type: object required: - meta - data title: PaginatedAssistantTestList description: |- 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. HTTPValidationError: title: HTTPValidationError type: object properties: detail: title: Detail type: array items: $ref: '#/components/schemas/ValidationError' Meta: properties: total_pages: type: integer total_results: type: integer page_number: type: integer page_size: type: integer type: object required: - total_pages - total_results - page_number - page_size title: Meta AssistantTestResponse: properties: test_id: type: string format: uuid title: Test Id description: Unique identifier for the assistant test. example: 123e4567-e89b-12d3-a456-426614174000 name: type: string title: Name description: Human-readable name of the test. example: Customer Support Bot Test description: type: string title: Description description: Detailed description of the test's purpose and scope. telnyx_conversation_channel: allOf: - $ref: '#/components/schemas/TelnyxConversationChannel' description: Communication channel used for test execution. example: web_chat destination: type: string title: Destination description: Target destination for test conversations. max_duration_seconds: type: integer title: Max Duration Seconds description: Maximum allowed duration for test execution in seconds. test_suite: type: string title: Test Suite description: Test suite grouping for organizational purposes. instructions: type: string title: Instructions description: Detailed test scenario instructions and objectives. rubric: items: type: object required: - name - criteria properties: name: type: string description: >- Label for the evaluation criterion, e.g., Empathy, Accuracy, Clarity. criteria: type: string description: >- Specific guidance on how to assess the assistant’s performance for this rubric item. additionalProperties: false type: array title: Rubric description: Evaluation criteria used to assess test performance. example: - criteria: Responds within 30 seconds name: Response Time created_at: type: string format: date-time title: Created At description: Timestamp when the test was created. example: '2024-01-16T09:00:00Z' type: object required: - test_id - name - telnyx_conversation_channel - rubric - created_at title: AssistantTestResponse description: |- Response model containing complete assistant test information. Returns all test configuration details including evaluation criteria, scheduling, and metadata. Used when retrieving individual tests or after creating/updating tests. ValidationError: title: ValidationError required: - loc - msg - type type: object properties: loc: title: Location type: array items: anyOf: - type: string - type: integer msg: title: Message type: string type: title: Error Type type: string TelnyxConversationChannel: type: string enum: - phone_call - web_call - sms_chat - web_chat title: TelnyxConversationChannel securitySchemes: bearerAuth: scheme: bearer type: http ````