GET
/
list-retell-llms
import Retell from 'retell-sdk';

const client = new Retell({
  apiKey: 'YOUR_RETELL_API_KEY',
});

async function main() {
  const llmResponses = await client.llm.list();

  console.log(llmResponses);
}

main();
[
  {
    "llm_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
    "version": 0,
    "is_published": false,
    "model": "gpt-4o",
    "s2s_model": "gpt-4o-realtime",
    "model_temperature": 0,
    "model_high_priority": true,
    "tool_call_strict_mode": true,
    "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"
            }
          }
        ]
      },
      {
        "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",
    "begin_message": "Hey I am a virtual assistant calling from Retell Hospital.",
    "default_dynamic_variables": {
      "customer_name": "John Doe"
    },
    "knowledge_base_ids": [
      "<string>"
    ],
    "last_modification_timestamp": 1703413636133
  }
]

Authorizations

​
Authorization
string
header
required

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

Response

200
application/json
Successfully retrieved all Retell LLM Response Engines.

The response is of type object[].