---
title: "GET /list-test-case-definitions"
method: GET
path: "/list-test-case-definitions"
deprecated: true
---

# GET /list-test-case-definitions

`GET /list-test-case-definitions`

> **Deprecated.**

List test case definitions for a response engine

## Query parameters

- `type` 'retell-llm' | 'conversation-flow', required
- `llm_id` string
- `conversation_flow_id` string

## Response `200`

Test case definitions retrieved successfully

- TestCaseDefinition[]
  - `name` string, required — Name of the test case definition
  - `response_engine` union, required — Response engine for test cases. Custom LLM is not supported.
    - ResponseEngineRetellLm
      - `type` 'retell-llm', required — type of the Response Engine.
      - `llm_id` string, required — id of the Retell LLM Response Engine.
      - `version` number, nullable — Version of the Retell LLM Response Engine.
    - ResponseEngineConversationFlow
      - `type` 'conversation-flow', required — type of the Response Engine.
      - `conversation_flow_id` string, required — ID of the Conversation Flow Response Engine.
      - `version` number, nullable — Version of the Conversation Flow Response Engine.
  - `user_prompt` string, required — User prompt to simulate in the test case
  - `metrics` string[], required — Array of metric names to evaluate
  - `dynamic_variables` object, required — Dynamic variables to inject into the response engine
  - `tool_mocks` ToolMock[], required — Mock tool calls for testing
    - `tool_name` string, required — Name of the tool to mock
    - `input_match_rule` union, required
      - object
        - `type` 'any', required — Match any input of the tool
      - object
        - `type` 'partial_match', required — Match only calls with specific arguments
        - `args` object, required — Arguments to match. Only provided fields will be checked
    - `output` string, required — The output of the tool call that will be fed into the LLM. Should be a JSON string.
    - `result` boolean, nullable — For tool calls like transfer_call that require a boolean result. Optional for most tools.
  - `llm_model` 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.5' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite', required — Available LLM models for agents.
  - `test_case_definition_id` string, required — Unique identifier for the test case definition
  - `type` 'simulation', required — Type of test case definition
  - `creation_timestamp` integer, required — Timestamp when the test case definition was created (milliseconds since epoch)
  - `user_modified_timestamp` integer, required — Timestamp when the test case definition was last modified (milliseconds since epoch)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/retellai/apis/retell-sdk.md) · [All operations](https://skmtc.net/retellai/apis/retell-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/retellai/retell-sdk/versions/2a182bedbfc5/schema)