--- title: "Changes to List Phone Numbers" method: GET path: "/v2/phone-number" --- # Changes to List Phone Numbers `GET /v2/phone-number` > Every recorded change to this operation, newest first. > 164 revisions in range; 15 not diffed, 8 could not be searched. ## Timeline Changed in 7 of 164 revisions. - **2025-11-18** `4c188bb946f2`: 30 info - **2025-11-03** `d052da8b4f6e`: 30 info - **2025-10-03** `61bab830871d`: 1 breaking - **2025-01-01** `55421929b4d3`: 1 breaking - **2024-12-11** `9a69c826773a`: 1 info - **2024-11-13** `57a4498f93a9`: 1 breaking - **2024-11-13** `07a626fedc22`: 1 info ## Changes - **2025-11-18** `4c188bb946f2`: 30 info - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/dialTimeout` to the response with the `200` status - **2025-11-03** `d052da8b4f6e`: 30 info - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/ByoPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TelnyxPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/TwilioPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VapiPhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/fallbackDestination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/fallbackDestination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #1: PhoneNumberHookCallRinging]/do/items/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #1: NumberTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/VonagePhoneNumber]/hooks/items/oneOf[subschema #2: PhoneNumberHookCallEnding]/do/oneOf[subschema #1: TransferPhoneNumberHookAction]/destination/oneOf[subschema #2: SipTransferDestination]/transferPlan/allOf[#/components/schemas/TransferPlan]/contextEngineeringPlan` to the response with the `200` status - **2025-10-03** `61bab830871d`: 1 breaking - api path removed without deprecation - …this revision’s changelog is incomplete - **2025-01-01** `55421929b4d3`: 1 breaking - api path removed without deprecation - **2024-12-11** `9a69c826773a`: 1 info - endpoint added - **2024-11-13** `57a4498f93a9`: 1 breaking - api path removed without deprecation - **2024-11-13** `07a626fedc22`: 1 info - endpoint added --- [Operation](https://skmtc.dev/vapiai/apis/vapi-api/docs/v2/phone-number/get.md) - [API](https://skmtc.dev/vapiai/apis/vapi-api.md) - [Page](https://skmtc.dev/vapiai/apis/vapi-api/changes/v2/phone-number/get)