---
title: "Changes to List Phone Numbers"
method: GET
path: "/v1/convai/phone-numbers"
---

# Changes to List Phone Numbers

`GET /v1/convai/phone-numbers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 142 revisions.

- **2026-07-13** `009bd651509a`: 5 info
- **2026-06-08** `37fac3c5a2d7`: 1 breaking, 9 info
- **2026-04-03** `deb5e58ddddf`: 6 info
- **2026-02-08** `5b595807512c`: 1 breaking, 1 info
- **2025-05-16** `503db4198a44`: 6 breaking, 1 warning, 3 info
- **2024-12-02** `d04ae85f47ff`: 1 info

## Changes

- **2026-07-13** `009bd651509a`: 5 info
  - added the new optional `query` request parameter `agent_id`
  - added the new optional `query` request parameter `branch_id`
  - added the new optional `query` request parameter `provider`
  - added the optional property `items/oneOf[subschema #3: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/enabled_codecs` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #3: GetPhoneNumberSIPTrunkResponseModel]/provider_config/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/enabled_codecs` to the response with the `200` status
- **2026-06-08** `37fac3c5a2d7`: 1 breaking, 9 info
  - added `#/components/schemas/GetPhoneNumberExotelResponseModel` to the `items/` response property `oneOf` list for the response status `200`
  - added the optional property `items/oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/branch_id` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/environment` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/branch_id` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/environment` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/inbound_trunk/anyOf[subschema #1: GetPhoneNumberInboundSIPTrunkConfigResponseModel]/attributes_to_headers` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/attributes_to_headers` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/provider_config/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/attributes_to_headers` to the response with the `200` status
  - added the optional property `items/oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/store_sip_messages` to the response with the `200` status
  - added `exotel` discriminator mapping keys to the `items/` response property for the response status `200`
- **2026-04-03** `deb5e58ddddf`: 6 info
  - the `livekit_stack` response's property default value `standard` was added for the status `200`
  - the `media_encryption` response's property default value `allowed` was added for the status `200`
  - the `media_encryption` response's property default value `allowed` was added for the status `200`
  - the `media_encryption` response's property default value `allowed` was added for the status `200`
  - the `transport` response's property default value `auto` was added for the status `200`
  - the `transport` response's property default value `auto` was added for the status `200`
- **2026-02-08** `5b595807512c`: 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2025-05-16** `503db4198a44`: 6 breaking, 1 warning, 3 info
  - added `#/components/schemas/GetPhoneNumberTwilioResponseModel, #/components/schemas/GetPhoneNumberSIPTrunkResponseModel` to the `items/` response property `oneOf` list for the response status `200`
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/label` from the response with the `200` status
  - removed the required property `items/phone_number` from the response with the `200` status
  - removed the required property `items/phone_number_id` from the response with the `200` status
  - removed the required property `items/provider` from the response with the `200` status
  - removed the optional property `items/assigned_agent` from the response with the `200` status
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
  - added discriminator to `items/` response property for the response status `200`
- **2024-12-02** `d04ae85f47ff`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/docs/v1/convai/phone-numbers/get.md) - [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [Page](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/phone-numbers/get)