Skip to main content
GET
/
v2
/
list-retell-llms
JavaScript
import Retell from 'retell-sdk';

const client = new Retell({
  apiKey: process.env['RETELL_API_KEY'], // This is the default and can be omitted
});

const llms = await client.llm.list();

console.log(llms.has_more);
{
  "pagination_key": "<string>",
  "has_more": true,
  "items": [
    {
      "llm_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
      "last_modification_timestamp": 1703413636133,
      "version": 0,
      "is_published": false,
      "model": "gpt-4.1",
      "s2s_model": "gpt-realtime-1.5",
      "model_temperature": 0,
      "model_high_priority": true,
      "tool_call_strict_mode": true,
      "knowledge_base_ids": [
        "<string>"
      ],
      "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": [
        {
          "name": "<string>",
          "url": "<string>",
          "headers": {
            "Authorization": "Bearer 1234567890"
          },
          "query_params": {
            "index": "1",
            "key": "value"
          },
          "timeout_ms": 123
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"

Query Parameters

limit
integer
default:50

Maximum number of items to return.

Required range: x <= 1000
sort_order
enum<string>
default:descending

Sort order for results.

Available options:
ascending,
descending
pagination_key
string

Pagination key for fetching the next page.

Response

Successfully retrieved Retell LLM Response Engines.

pagination_key
string

Pagination key for the next page.

has_more
boolean

Whether more results are available.

items
object[]