curl --request GET \
--url https://api.retellai.com/v2/list-retell-llms \
--header 'Authorization: Bearer <token>'{
"pagination_key": "<string>",
"has_more": true,
"items": [
{
"llm_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"last_modification_timestamp": 1703413636133,
"version": 1,
"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
},
"start_speaker": "user",
"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
}
]
}
]
}List Retell LLM Response Engines with pagination
curl --request GET \
--url https://api.retellai.com/v2/list-retell-llms \
--header 'Authorization: Bearer <token>'{
"pagination_key": "<string>",
"has_more": true,
"items": [
{
"llm_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"last_modification_timestamp": 1703413636133,
"version": 1,
"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
},
"start_speaker": "user",
"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
}
]
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.retellai.com/llms.txt
Use this file to discover all available pages before exploring further.
Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"
Maximum number of items to return.
x <= 1000Sort order for results.
ascending, descending Pagination key for fetching the next page.
Was this page helpful?