Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{CountryCode}.json

Get available phone number country information

Retrieves available phone number information for a specific country. Supply CountryCode as an ISO 3166-1 country code to obtain the country's name, resource URI, beta status, and related available-phone-number resources.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
AccountSidstringrequired
The 34-character SID of the account requesting available phone number country information. Must match the `AC` account SID format.
CountryCodestringrequired
The ISO 3166-1 country code of the country whose available phone number information to retrieve.

1 status code
200Returns the country resource, including its ISO country code, name, resource URI, beta status, and related available-phone-number resource URIs.
country_codestringoptional
The [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the country.
countrystringoptional
The name of the country.
uristringoptional
The URI of the Country resource, relative to `https://api.twilio.com`.
betabooleanoptional
Whether all phone numbers available in the country are new to the Twilio platform. `true` if they are and `false` if all numbers are not in the Twilio Phone Number Beta program.
subresource_urisobjectoptional
A list of related AvailablePhoneNumber resources identified by their URIs relative to `https://api.twilio.com`.

Error handling

AccountSid must be a 34-character SID matching the AC account pattern. CountryCode must use the ISO 3166-1 country-code format and identify the country whose available phone number information you want to retrieve.