---
title: "Changes to POST /v2/list-calls"
method: POST
path: "/v2/list-calls"
---

# Changes to POST /v2/list-calls

`POST /v2/list-calls`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 13 of 28 revisions.

- **2026-05-28** `40402ca870b9` — 4 breaking, 2 warning, 1 info
- **2026-05-18** `6342a9990108` — 4 breaking
- **2026-05-12** `6dff2a12f866` — 4 breaking
- **2026-04-28** `1b4a9d84942a` — 1 info
- **2026-04-20** `8ee53928bf31` — 2 warning, 5 info
- **2026-03-19** `3aa6f6e028ef` — 1 info
- **2026-03-09** `8fbf8c54a142` — 3 breaking
- **2026-02-26** `e89903d2c910` — 1 breaking, 6 warning, 3 info
- **2026-02-23** `bcff6899fa2a` — 1 breaking, 6 info
- **2026-02-18** `fa2738401683` — 2 warning, 1 info
- **2026-02-10** `0bf5cea5dfcc` — 2 info
- **2026-01-23** `427e77039f39` — 2 info
- **2026-01-19** `9dbbdaf34f4b` — 2 info

## Changes

- **2026-05-28** `40402ca870b9` — 4 breaking, 2 warning, 1 info
  - added `#/components/schemas/InjectedUtterance` to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/InjectedUtterance` to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/InjectedUtterance` to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/InjectedUtterance` to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added the new `no_concurrency_fallback` enum value to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `no_concurrency_fallback` enum value to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `no_concurrency_fallback` enum value to the request property `filter_criteria/disconnection_reason/items/`
- **2026-05-18** `6342a9990108` — 4 breaking
  - added `#/components/schemas/SmsUtterance` to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SmsUtterance` to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SmsUtterance` to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SmsUtterance` to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/` response property `oneOf` list for the response status `200`
- **2026-05-12** `6dff2a12f866` — 4 breaking
  - the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/collected_dynamic_variables/additionalProperties/` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/retell_llm_dynamic_variables/additionalProperties/` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/collected_dynamic_variables/additionalProperties/` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/retell_llm_dynamic_variables/additionalProperties/` response's property type/format changed from ``/`` to `string`/`` for status `200`
- **2026-04-28** `1b4a9d84942a` — 1 info
  - endpoint deprecated
- **2026-04-20** `8ee53928bf31` — 2 warning, 5 info
  - added the new `manual_stopped` enum value to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `manual_stopped` enum value to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `manual_stopped` enum value to the request property `filter_criteria/disconnection_reason/items/`
  - added the optional property `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/oneOf[#/components/schemas/NodeTransitionUtterance]/transition_type` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/oneOf[#/components/schemas/NodeTransitionUtterance]/transition_type` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/oneOf[#/components/schemas/NodeTransitionUtterance]/transition_type` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/oneOf[#/components/schemas/NodeTransitionUtterance]/transition_type` to the response with the `200` status
- **2026-03-19** `3aa6f6e028ef` — 1 info
  - added the new optional request property `filter_criteria/call_id`
- **2026-03-09** `8fbf8c54a142` — 3 breaking
  - the `filter_criteria/agent_id/items/` request property's minLength was increased from `0` to `1`
  - the `filter_criteria/from_number/items/` request property's minLength was increased from `0` to `1`
  - the `filter_criteria/to_number/items/` request property's minLength was increased from `0` to `1`
- **2026-02-26** `e89903d2c910` — 1 breaking, 6 warning, 3 info
  - removed the enum value `registered` of the request property `filter_criteria/call_status/items/`
  - added the new `ivr_reached` enum value to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `ivr_reached` enum value to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `transfer_bridged` enum value to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `transfer_bridged` enum value to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `transfer_cancelled` enum value to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `transfer_cancelled` enum value to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `ivr_reached` enum value to the request property `filter_criteria/disconnection_reason/items/`
  - added the new `transfer_bridged` enum value to the request property `filter_criteria/disconnection_reason/items/`
  - added the new `transfer_cancelled` enum value to the request property `filter_criteria/disconnection_reason/items/`
- **2026-02-23** `bcff6899fa2a` — 1 breaking, 6 info
  - removed the enum value `ivr_reached` of the request property `filter_criteria/disconnection_reason/items/`
  - added the optional property `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/oneOf[#/components/schemas/ToolCallResultUtterance]/successful` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/oneOf[#/components/schemas/ToolCallResultUtterance]/successful` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/scrubbed_transcript_with_tool_calls/items/oneOf[#/components/schemas/ToolCallResultUtterance]/successful` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/transcript_with_tool_calls/items/oneOf[#/components/schemas/ToolCallResultUtterance]/successful` to the response with the `200` status
  - removed the `ivr_reached` enum value from the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - removed the `ivr_reached` enum value from the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
- **2026-02-18** `fa2738401683` — 2 warning, 1 info
  - added the new `ivr_reached` enum value to the `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `ivr_reached` enum value to the `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/disconnection_reason` response property for the response status `200`
  - added the new `ivr_reached` enum value to the request property `filter_criteria/disconnection_reason/items/`
- **2026-02-10** `0bf5cea5dfcc` — 2 info
  - added the optional property `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/call_cost/product_costs/items/is_transfer_leg_cost` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/call_cost/product_costs/items/is_transfer_leg_cost` to the response with the `200` status
- **2026-01-23** `427e77039f39` — 2 info
  - added the optional property `items/oneOf[#/components/schemas/V2PhoneCallResponse]/allOf[#/components/schemas/V2CallBase]/transfer_end_timestamp` to the response with the `200` status
  - added the optional property `items/oneOf[#/components/schemas/V2WebCallResponse]/allOf[#/components/schemas/V2CallBase]/transfer_end_timestamp` to the response with the `200` status
- **2026-01-19** `9dbbdaf34f4b` — 2 info
  - added the new optional request property `filter_criteria/dynamic_variables`
  - added the new optional request property `filter_criteria/metadata`

---

[Operation](https://skmtc.dev/retellai/apis/retell-sdk/docs/v2/list-calls/post.md) · [API](https://skmtc.dev/retellai/apis/retell-sdk.md) · [Page](https://skmtc.dev/retellai/apis/retell-sdk/changes/v2/list-calls/post)