---
title: "Find toll-free numbers"
method: GET
path: "/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/TollFree"
tags: ["Available Phone Numbers"]
---

# Find toll-free numbers

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

Searches SignalWire inventory for toll-free phone numbers available in one ISO country. Results are candidates, not project resources, until purchased through Incoming Phone Numbers or the native purchase operation. Use the [local search](/docs/compatibility-api/rest/available-phone-numbers/search-local-available-phone-numbers) for local inventory, or native [Search phone numbers](/docs/apis/rest/phone-numbers/search-available-phone-numbers) for the JSON API.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `AccountSid` string, uuid, required — Universal Unique Identifier.
- `IsoCountry` string, required

## Query parameters

- `AreaCode` string
- `Beta` boolean
- `Contains` string
- `ExcludeAllAddressRequired` boolean
- `ExcludeForeignAddressRequired` boolean
- `ExcludeLocalAddressRequired` boolean
- `FaxEnabled` boolean
- `InLocality` string
- `InRegion` string
- `MmsEnabled` boolean
- `SmsEnabled` boolean
- `VoiceEnabled` boolean

## Response `200`

The request has succeeded.

- AvailablePhoneNumberListResponse — Response containing a list of available phone numbers.
  - `uri` string, required — The URI for the API call.
  - `available_phone_numbers` AvailablePhoneNumber[], required — List of available phone numbers.
    - `friendly_name` string, required — A formatted version of the number.
    - `phone_number` string, required — The number in E.164 format.
    - `lata` string, nullable, required — The LATA of the number. Always null.
    - `locality` string, nullable, required — The locality/city of the number. Always null.
    - `rate_center` string, nullable, required — The rate center of the number. Only available for numbers in US and Canada.
    - `latitude` string, nullable, required — The latitude of the number. Always null.
    - `longitude` string, nullable, required — The longitude of the number. Always null.
    - `region` string, nullable, required — The state or province abbreviation of the number. Only available for numbers in US and Canada.
    - `postal_code` string, nullable, required — The postal/zip code of the number. Always null.
    - `iso_country` string, required — The ISO country code of the number.
    - `capabilities` PhoneNumberCapabilities, required — Phone number capabilities.
      - `voice` boolean, required — Whether or not voice is enabled on the number.
      - `SMS` boolean, required — Whether or not SMS is enabled on the number.
      - `MMS` boolean, required — Whether or not MMS is enabled on the number.
    - `beta` boolean, required — Always `false`. Retained for response-shape compatibility.

## Other responses

- `400` — The request was invalid or cannot be processed. Check the error details for more information.
- `401` — Authentication failed. Please verify your credentials and try again.
- `422` — The request could not be processed due to validation errors. Check the error details for more information.

## 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`
  - …2 more
- **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`
  - …3 more
- **2026-01-20** `dce1bcef69f0` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `422`
- …earlier changes not shown

[Full history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/AvailablePhoneNumbers/:IsoCountry/TollFree/get.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/723316346320/schema)