Deprecating on 06/15/2026

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.

​

Legacy list endpoints are deprecated

• List Batch Tests
• List Conversation Flow Components
• List Conversation Flows
• List Phone Numbers
• List Retell LLMs
• List Test Case Definitions
• List Test Runs
• List Calls
• List Chats

​

Endpoint migrations

• GET /list-batch-tests -> GET /v2/list-batch-tests (List Batch Tests)
• GET /list-conversation-flow-components -> GET /v2/list-conversation-flow-components (List Conversation Flow Components)
• GET /list-conversation-flows -> GET /v2/list-conversation-flows (List Conversation Flows)
• GET /list-phone-numbers -> GET /v2/list-phone-numbers (List Phone Numbers)
• GET /list-retell-llms -> GET /v2/list-retell-llms (List Retell LLMs)
• GET /list-test-case-definitions -> GET /v2/list-test-case-definitions (List Test Case Definitions)
• GET /list-test-runs/{test_case_batch_job_id} -> GET /v2/list-test-runs/{test_case_batch_job_id} (List Test Runs)
• POST /v2/list-calls -> POST /v3/list-calls (List Calls)
• GET /list-chat -> POST /v3/list-chats (List Chats)

1. The legacy list endpoints above will no longer be supported.
2. GET /list-chat changes both method and path to POST /v3/list-chats.
3. Versioned list endpoints return unified pagination fields: items, pagination_key, and has_more.

• Update each client call to the new method/path listed above.
• Update response handling to read items from the paginated response object (instead of expecting a top-level array from legacy endpoints).
• Keep using pagination_key and has_more for page traversal.