GET /v2/list-retell-llms – Retell AI Retell SDK

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
    }
  ]
}

Changes

Changed in 6 of the 28 revisions of this API.4210

May 28, 202640402ca870b96See the full diff
- ○
  added the optional property ////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////////// to the response with the status
  response-optional-property-added
- ○
  the /////////////// response's property pattern was changed from ^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$ to ^(latest|latest_published|(?!(?:latest|latest_published|v\d+)$)[a-z][a-z0-9_-]{0,19})$ for the status
  response-property-pattern-changed
- ○
  the /////////////////// response's property pattern was changed from ^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$ to ^(latest|latest_published|(?!(?:latest|latest_published|v\d+)$)[a-z][a-z0-9_-]{0,19})$ for the status
  response-property-pattern-changed
- ○
  the ///////////////// response's property pattern was changed from ^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$ to ^(latest|latest_published|(?!(?:latest|latest_published|v\d+)$)[a-z][a-z0-9_-]{0,19})$ for the status
  response-property-pattern-changed
- ○
  the ///////////////////// response's property pattern was changed from ^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$ to ^(latest|latest_published|(?!(?:latest|latest_published|v\d+)$)[a-z][a-z0-9_-]{0,19})$ for the status
  response-property-pattern-changed
May 18, 20266342a99901081See the full diff
- ●
  removed the optional property //////// from the response with the status
  response-optional-property-removed
May 11, 20267c30e3ea25361See the full diff
- ●
  added the new gpt-realtime-2 enum value to the /////////// response property for the response status
  response-property-enum-value-added
May 8, 20267dd16ddf69d822See the full diff
- ▲
  response property allOf[subschema #2]/items/items/allOf[RetellLlmRequest]/allOf[subschema #2]/general_tools/items/oneOf[TransferCallTool]/transfer_option/oneOf[subschema #3: Agentic Warm Transfer]/agentic_transfer_config/transfer_agent/agent_version list-of-types was widened by adding types integer and string to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property allOf[subschema #2]/items/items/allOf[RetellLlmRequest]/allOf[subschema #2]/states/items/tools/items/oneOf[TransferCallTool]/transfer_option/oneOf[subschema #3: Agentic Warm Transfer]/agentic_transfer_config/transfer_agent/agent_version list-of-types was widened by adding types integer and string to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  the /////////////// response's property pattern was changed from ^[a-z0-9_-]+$ to ^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$ for the status
  response-property-pattern-changed
- ○
  the ///////////////// response's property pattern was changed from ^[a-z0-9_-]+$ to ^(latest|(?!(?:v\d+)$)[a-z][a-z0-9_-]{0,19})$ for the status
  response-property-pattern-changed
May 7, 2026f1a0d7c1e36c21See the full diff
- ▲
  response property allOf[subschema #2]/items/items/allOf[RetellLlmRequest]/allOf[subschema #2]/general_tools/items/oneOf[AgentSwapTool]/agent_version list-of-types was widened by adding types integer and string to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property allOf[subschema #2]/items/items/allOf[RetellLlmRequest]/allOf[subschema #2]/states/items/tools/items/oneOf[AgentSwapTool]/agent_version list-of-types was widened by adding types integer and string to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  removed the gemini-2.5-flash enum value from the /////////// response property for the response status
  response-property-enum-value-removed
Apr 28, 20261b4a9d84942a1See the full diff
- ○
  endpoint added
  endpoint-added

Full history