GET /v2/list-test-case-definitions

Changed on

List test case definitions with pagination

Request

  • Base URL
    https://api.retellai.com
  • Auth
    HTTP bearer

Query parameters

type'retell-llm' | 'conversation-flow' required

Type of response engine

llm_idstring

LLM ID (required when type is retell-llm)

conversation_flow_idstring

Conversation flow ID (required when type is conversation-flow)

limitinteger

Maximum number of items to return.

pagination_keystring

Pagination key for fetching the next page.

Response

Test case definitions retrieved successfully

pagination_keystring

Pagination key for the next page.

has_moreboolean required

Whether more results are available.

Changes

    • warning

      added the new gpt-6.1-terra enum value to the /////// response property for the response status

    • breaking

      added subschema #1 subschema #2 to the ///////// response property oneOf list for the response status

    • warning

      added the new claude-5-opus enum value to the /////// response property for the response status

    • warning

      added the new claude-5-sonnet enum value to the /////// response property for the response status

    • warning

      added the new claude-5.5-haiku enum value to the /////// response property for the response status

    • warning

      added the new claude-5.5-opus enum value to the /////// response property for the response status

    • warning

      added the new claude-5.5-sonnet enum value to the /////// response property for the response status

    • warning

      added the new gemini-3.5-flash enum value to the /////// response property for the response status

    • warning

      added the new gemini-3.5-flash-lite enum value to the /////// response property for the response status

    • warning

      added the new gemini-3.6-flash enum value to the /////// response property for the response status

    • warning

      added the new gemini-3.7-flash enum value to the /////// response property for the response status

    • warning

      added the new gemini-3.8-flash enum value to the /////// response property for the response status

    • warning

      added the new gemini-4-argon enum value to the /////// response property for the response status

    • warning

      added the new gpt-5.6-luna enum value to the /////// response property for the response status

    • warning

      added the new gpt-5.6-terra enum value to the /////// response property for the response status

    • warning

      added the new gpt-6-astra enum value to the /////// response property for the response status

    • warning

      added the new gpt-6-luna enum value to the /////// response property for the response status

    • warning

      added the new gpt-6-sol enum value to the /////// response property for the response status

    • warning

      added the new gpt-6.1-sol enum value to the /////// response property for the response status

    • info

      api operation id listTestCaseDefinitionsV2 removed and replaced with listTestCaseDefinitions

    • info

      the response property //// became required for the status

    • info

      the response property / became required for the status

    • info

      removed the claude-4.5-sonnet enum value from the /////// response property for the response status

    • info

      removed the gemini-2.5-flash-lite enum value from the /////// response property for the response status

    • info

      removed the gpt-4.1-nano enum value from the /////// response property for the response status

    • info

      removed subschema #1 subschema #2 from the ///////// response property oneOf list for the response status