> ## 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.

# Deprecating on 06/15/2026

## Legacy list endpoints are deprecated

The following list endpoints are deprecated in favor of newer versioned endpoints with unified pagination patterns.

**Affected APIs:**

* [List Batch Tests](/api-references/list-batch-tests)
* [List Conversation Flow Components](/api-references/list-conversation-flow-components)
* [List Conversation Flows](/api-references/list-conversation-flows)
* [List Phone Numbers](/api-references/list-phone-numbers)
* [List Retell LLMs](/api-references/list-retell-llms)
* [List Test Case Definitions](/api-references/list-test-case-definitions)
* [List Test Runs](/api-references/list-test-runs)
* [List Calls](/api-references/list-calls)
* [List Chats](/api-references/list-chats)

## Endpoint migrations

* `GET /list-batch-tests` -> `GET /v2/list-batch-tests` ([List Batch Tests](/api-references/list-batch-tests))
* `GET /list-conversation-flow-components` -> `GET /v2/list-conversation-flow-components` ([List Conversation Flow Components](/api-references/list-conversation-flow-components))
* `GET /list-conversation-flows` -> `GET /v2/list-conversation-flows` ([List Conversation Flows](/api-references/list-conversation-flows))
* `GET /list-phone-numbers` -> `GET /v2/list-phone-numbers` ([List Phone Numbers](/api-references/list-phone-numbers))
* `GET /list-retell-llms` -> `GET /v2/list-retell-llms` ([List Retell LLMs](/api-references/list-retell-llms))
* `GET /list-test-case-definitions` -> `GET /v2/list-test-case-definitions` ([List Test Case Definitions](/api-references/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](/api-references/list-test-runs))
* `POST /v2/list-calls` -> `POST /v3/list-calls` ([List Calls](/api-references/list-calls))
* `GET /list-chat` -> `POST /v3/list-chats` ([List Chats](/api-references/list-chats))

**What's changing on 06/15/2026:**

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`.

**Migration:**

* 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.

**Effective date:** After 06/15/2026, the legacy endpoints listed above will no longer be supported.