---
title: "Changes to Get Phone Number"
method: GET
path: "/v1/convai/phone-numbers/{phone_number_id}"
---

# Changes to Get Phone Number

`GET /v1/convai/phone-numbers/{phone_number_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 108 revisions.

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

## Changes

- **2026-07-13** `009bd651509a`: 2 info
  - added the optional property `oneOf[subschema #3: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk/anyOf[subschema #1: GetPhoneNumberOutboundSIPTrunkConfigResponseModel]/enabled_codecs` to the response with the `200` status
  - added the optional property `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 response body `oneOf` list for the response status `200`
  - added `exotel` mapping keys to the response discriminator for the response status `200`
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/branch_id` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/assigned_agent/anyOf[subschema #1: PhoneNumberAgentInfo]/environment` to the response with the `200` status
  - added the optional property `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 `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 `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 `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 `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 `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel -> subschema #3: GetPhoneNumberSIPTrunkResponseModel]/store_sip_messages` to the response with the `200` status
- **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`: 13 info
  - api operation id `Get_phone_number_v1_convai_phone_numbers__phone_number_id__get` removed and replaced with `get_phone_number_route`
  - api tag `Agents Platform` added
  - api tag `Conversational AI` removed
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/supports_inbound` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: GetPhoneNumberTwilioResponseModel]/supports_outbound` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/inbound_trunk` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/outbound_trunk` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/supports_inbound` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/supports_outbound` to the response with the `200` status
  - added `#/components/schemas/GetPhoneNumberOutboundSIPTrunkConfigResponseModel` to the `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/provider_config` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/SIPTrunkConfigResponseModel` from the `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/provider_config` response property `anyOf` list for the response status `200`
  - response property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/provider_config` deprecated
  - added the required property `oneOf[subschema #2: GetPhoneNumberSIPTrunkResponseModel]/livekit_stack` to the response with the `200` status
- **2025-05-16** `503db4198a44`: 6 breaking, 1 warning, 3 info
  - added `#/components/schemas/GetPhoneNumberTwilioResponseModel, #/components/schemas/GetPhoneNumberSIPTrunkResponseModel` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `label` from the response with the `200` status
  - removed the required property `phone_number` from the response with the `200` status
  - removed the required property `phone_number_id` from the response with the `200` status
  - removed the required property `provider` from the response with the `200` status
  - removed the optional property `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 response discriminator 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/:phone_number_id/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/:phone_number_id/get)