---
title: "List of AvailablePhoneNumber resources by country"
method: GET
path: "/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountry}"
tags: ["Available Phone Numbers"]
---

# List of AvailablePhoneNumber resources by country

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

Returns a list of URIs to phone number resources available to the account in the specified ISO country, categorized by type (Local, Toll-Free, Mobile, etc).

#### 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

## Response `200`

The request has succeeded.

- AvailablePhoneNumberByCountryResponse — Response containing available phone number resources for a specific country.
  - `country_code` string, required — The ISO country code of the number.
  - `country` string, required — The country the number is from.
  - `uri` string, required — The URI for the API call.
  - `beta` boolean, required — New numbers on SignalWire are marked as `beta`.
  - `subresource_uris` CountrySubresourceUris, required — Country subresource URIs.
    - `local` string, required — The URI for local numbers.
    - `toll_free` string, required — The URI for toll-free numbers.

## 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.

---

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