v28

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-05-2887246443.7 KB

List Retell LLM Response Engines with pagination

get/v2/list-retell-llms

Query parameters

limitinteger

Maximum number of items to return.

sort_order'ascending' | 'descending'

Sort order for results.

pagination_keystring

Pagination key for fetching the next page.

Response

Successfully retrieved Retell LLM Response Engines.

pagination_keystring

Pagination key for the next page.

has_moreboolean

Whether more results are available.

Example response

{
  "items": [
    {
      "llm_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
      "s2s_model": "gpt-realtime-1.5",
      "model_high_priority": true,
      "tool_call_strict_mode": true,
      "kb_config": {
        "top_k": 3,
        "filter_score": 0.6
      },
      "begin_after_user_silence_ms": 2000,
      "begin_message": "Hey I am a virtual assistant calling from Retell Hospital.",
      "general_prompt": "You are ...",
      "general_tools": [
        {
          "type": "end_call",
          "name": "end_call",
          "description": "End the call with user."
        }
      ],
      "states": [
        {
          "name": "information_collection",
          "state_prompt": "You will follow the steps below to collect information...",
          "edges": [
            {
              "destination_state_name": "appointment_booking",
              "description": "Transition to book an appointment."
            }
          ],
          "tools": [
            {
              "type": "transfer_call",
              "name": "transfer_to_support",
              "description": "Transfer to the support team.",
              "transfer_destination": {
                "type": "predefined",
                "number": "16175551212",
                "ignore_e164_validation": false
              },
              "transfer_option": {
                "type": "cold_transfer",
                "show_transferee_as_caller": false
              }
            }
          ]
        },
        {
          "name": "appointment_booking",
          "state_prompt": "You will follow the steps below to book an appointment...",
          "tools": [
            {
              "type": "book_appointment_cal",
              "name": "book_appointment",
              "description": "Book an annual check up.",
              "cal_api_key": "cal_live_xxxxxxxxxxxx",
              "event_type_id": 60444,
              "timezone": "America/Los_Angeles"
            }
          ]
        }
      ],
      "starting_state": "information_collection",
      "default_dynamic_variables": {
        "customer_name": "John Doe"
      },
      "mcps": [
        {
          "headers": {
            "Authorization": "Bearer 1234567890"
          },
          "query_params": {
            "index": "1",
            "key": "value"
          }
        }
      ],
      "last_modification_timestamp": 1703413636133
    }
  ]
}