---
title: "Get assistant test by ID"
method: GET
path: "/ai/assistants/tests/{test_id}"
tags: ["Assistants"]
---

# Get assistant test by ID

`GET /ai/assistants/tests/{test_id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/assistants/tests/{test_id}`
- Auth: HTTP bearer

Retrieves detailed information about a specific assistant test

## Path parameters

- `test_id` string, required

## Response `200`

Returns complete test configuration including rubric, schedule, and metadata

- AssistantTestResponse: 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.
  - `test_id` string, uuid, required: Unique identifier for the assistant test.
  - `name` string, required: Human-readable name of the test.
  - `description` string: Detailed description of the test's purpose and scope.
  - `telnyx_conversation_channel` 'phone_call' | 'web_call' | 'sms_chat' | 'web_chat', required
  - `destination` string: Target destination for test conversations.
  - `max_duration_seconds` integer: Maximum allowed duration for test execution in seconds.
  - `test_suite` string: Test suite grouping for organizational purposes.
  - `instructions` string: Detailed test scenario instructions and objectives.
  - `rubric` object[], required: Evaluation criteria used to assess test performance.
    - `name` string, required: Label for the evaluation criterion, e.g., Empathy, Accuracy, Clarity.
    - `criteria` string, required: Specific guidance on how to assess the assistant’s performance for this rubric item.
  - `created_at` string, date-time, required: Timestamp when the test was created.

## Other responses

- `422`: Validation Error

---

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