---
title: "Search for available phone numbers that match your criteria."
method: GET
path: "/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}/Local"
tags: ["Available Phone Numbers"]
---

# Search for available phone numbers that match your criteria.

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

Searches SignalWire inventory for local 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 [toll-free search](/docs/compatibility-api/rest/available-phone-numbers/search-toll-free-available-phone-numbers) for toll-free 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.

---

[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)