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

# List of AvailablePhoneNumber resources

`GET /Accounts/{AccountSid}/AvailablePhoneNumbers`

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

#### 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](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).

## Path parameters

- `AccountSid` string, uuid, required

## Response `200`

The request has succeeded.

- AvailablePhoneNumberResourcesResponse — Response containing a list of available phone number resources (countries).
  - `uri` string, required — The URI for the API call.
  - `countries` CountryResource[], required — List of available countries.
    - `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 — Always `false`. Included for Twilio API compatibility.
    - `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.

## Changes

- **2026-01-20** `dce1bcef69f0` — 1 info
  - added the non-success response with the status `400`
- **2026-01-19** `d5fbaaddfa3e` — 1 breaking, 3 info
  - the `countries` response's property type/format changed from ``/`` to `array`/`` for status `200`
  - removed `#/components/schemas/CountryResource` from the `countries` response property `allOf` list for the response status `200`
  - the response property `countries` became required for the status `200`
  - the response property `uri` became required for the status `200`
- **2026-01-15** `a10b019314cd` — 4 warning, 1 info
  - removed the optional property `beta` from the response with the `200` status
  - removed the optional property `country` from the response with the `200` status
  - removed the optional property `country_code` from the response with the `200` status
  - removed the optional property `subresource_uris` from the response with the `200` status
  - …1 more
- **2026-01-15** `518ffc8751b7` — 1 warning, 4 info
  - removed the optional property `countries` from the response with the `200` status
  - added the optional property `beta` to the response with the `200` status
  - added the optional property `country` to the response with the `200` status
  - added the optional property `country_code` to the response with the `200` status
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/AvailablePhoneNumbers/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/8891278c1908/schema)