---
title: "Changes to Find toll-free numbers"
method: GET
path: "/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree"
---

# Changes to Find toll-free numbers

`GET /Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 40 revisions.

- **2026-05-12** `5344c0c93a4c` — 6 info
- **2026-03-04** `2e516ba2383f` — 7 breaking
- **2026-01-20** `dce1bcef69f0` — 2 info
- **2026-01-19** `d5fbaaddfa3e` — 6 breaking, 1 warning, 18 info
- **2026-01-15** `3c88f14db21e` — 3 breaking, 4 warning, 13 info

## Changes

- **2026-05-12** `5344c0c93a4c` — 6 info
  - added 'unevaluatedProperties' constraint to the response body for the status `200`
  - added 'unevaluatedProperties' constraint to the response body for the status `400`
  - added 'unevaluatedProperties' constraint to the response body for the status `401`
  - added 'unevaluatedProperties' constraint to the response body for the status `422`
  - added 'unevaluatedProperties' constraint to the `available_phone_numbers/items/` response property for the status `200`
  - added 'unevaluatedProperties' constraint to the `available_phone_numbers/items/capabilities/allOf[#/components/schemas/PhoneNumberCapabilities]/` response property for the status `200`
- **2026-03-04** `2e516ba2383f` — 7 breaking
  - response property `available_phone_numbers/items/lata` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_phone_numbers/items/latitude` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_phone_numbers/items/locality` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_phone_numbers/items/longitude` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_phone_numbers/items/postal_code` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_phone_numbers/items/rate_center` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `available_phone_numbers/items/region` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-01-20** `dce1bcef69f0` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `422`
- **2026-01-19** `d5fbaaddfa3e` — 6 breaking, 1 warning, 18 info
  - the response property `available_phone_numbers/items/lata` became nullable for the status `200`
  - the response property `available_phone_numbers/items/latitude` became nullable for the status `200`
  - the response property `available_phone_numbers/items/longitude` became nullable for the status `200`
  - the response property `available_phone_numbers/items/postal_code` became nullable for the status `200`
  - the response property `available_phone_numbers/items/rate_center` became nullable for the status `200`
  - the response property `available_phone_numbers/items/region` became nullable for the status `200`
  - removed the optional property `available_phone_numbers/items/capabilities/allOf[#/components/schemas/PhoneNumberCapabilities]/fax` from the response with the `200` status
  - added the new optional `query` request parameter `InLocality`
  - the response property `available_phone_numbers` became required for the status `200`
  - the response property `available_phone_numbers/items/beta` became required for the status `200`
  - the response property `available_phone_numbers/items/capabilities` became required for the status `200`
  - the response property `available_phone_numbers/items/capabilities/allOf[#/components/schemas/PhoneNumberCapabilities]/MMS` became required for the status `200`
  - the response property `available_phone_numbers/items/capabilities/allOf[#/components/schemas/PhoneNumberCapabilities]/SMS` became required for the status `200`
  - the response property `available_phone_numbers/items/capabilities/allOf[#/components/schemas/PhoneNumberCapabilities]/voice` became required for the status `200`
  - the response property `available_phone_numbers/items/friendly_name` became required for the status `200`
  - the response property `available_phone_numbers/items/iso_country` became required for the status `200`
  - the response property `available_phone_numbers/items/lata` became required for the status `200`
  - the response property `available_phone_numbers/items/latitude` became required for the status `200`
  - the response property `available_phone_numbers/items/longitude` became required for the status `200`
  - the response property `available_phone_numbers/items/phone_number` became required for the status `200`
  - the response property `available_phone_numbers/items/postal_code` became required for the status `200`
  - the response property `available_phone_numbers/items/rate_center` became required for the status `200`
  - the response property `available_phone_numbers/items/region` became required for the status `200`
  - the response property `uri` became required for the status `200`
  - added the required property `available_phone_numbers/items/locality` to the response with the `200` status
- **2026-01-15** `3c88f14db21e` — 3 breaking, 4 warning, 13 info
  - added the new path request parameter `AccountSid`
  - added the new path request parameter `IsoCountry`
  - the `available_phone_numbers/items/capabilities` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `available_phone_numbers/items/capabilities/MMS` from the response with the `200` status
  - removed the optional property `available_phone_numbers/items/capabilities/SMS` from the response with the `200` status
  - removed the optional property `available_phone_numbers/items/capabilities/fax` from the response with the `200` status
  - removed the optional property `available_phone_numbers/items/capabilities/voice` from the response with the `200` status
  - added the new optional `query` request parameter `AreaCode`
  - added the new optional `query` request parameter `Beta`
  - added the new optional `query` request parameter `Contains`
  - added the new optional `query` request parameter `ExcludeAllAddressRequired`
  - added the new optional `query` request parameter `ExcludeForeignAddressRequired`
  - added the new optional `query` request parameter `ExcludeLocalAddressRequired`
  - added the new optional `query` request parameter `FaxEnabled`
  - added the new optional `query` request parameter `InRegion`
  - added the new optional `query` request parameter `MmsEnabled`
  - added the new optional `query` request parameter `SmsEnabled`
  - added the new optional `query` request parameter `VoiceEnabled`
  - added the non-success response with the status `401`
  - added `#/components/schemas/PhoneNumberCapabilities` to the `available_phone_numbers/items/capabilities` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/signalwire/apis/compatibility-api/docs/Accounts/:AccountSid/AvailablePhoneNumbers/:IsoCountry/TollFree/get.md) · [API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [Page](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/AvailablePhoneNumbers/:IsoCountry/TollFree/get)
