List available phone number country

GET /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers.json

Country codes with available phone numbers

Path parameters

  • AccountSid string Required

    The SID of the Account requesting the available phone number Country resources.

Query parameters

  • PageSize integer

    How many resources to return in each list page. The default is 50, and the maximum is 1000.

    Minimum value is 1, maximum value is 1000.

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • countries array[object]
      Hide countries attributes Show countries attributes array[object]
      • beta boolean | null

        Whether all phone numbers available in the country are new to the Twilio platform.

      • country string | null

        The name of the country

      • country_code string(iso-country-code) | null

        The ISO-3166-1 country code of the country.

      • subresource_uris object(uri-map) | null

        A list of related resources identified by their relative URIs

      • uri string(uri) | null

        The URI of the Country resource, relative to https://api.twilio.com

    • end integer
    • first_page_uri string(uri)
    • next_page_uri string(uri)
    • page integer
    • page_size integer
    • previous_page_uri string(uri)
    • start integer
    • uri string(uri)
GET /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers.json
curl \
 -X GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers.json \
 --user "username:password"
Response examples (200)
{
  "countries": [
    {
      "beta": true,
      "country": "string",
      "country_code": "string",
      "subresource_uris": {},
      "uri": "https://example.com"
    }
  ],
  "end": 42,
  "first_page_uri": "https://example.com",
  "next_page_uri": "https://example.com",
  "page": 42,
  "page_size": 42,
  "previous_page_uri": "https://example.com",
  "start": 42,
  "uri": "https://example.com"
}
Response examples (200)
{
  "countries": [
    {
      "beta": true,
      "country": "string",
      "country_code": "string",
      "subresource_uris": {},
      "uri": "https://example.com"
    }
  ],
  "end": 42,
  "first_page_uri": "https://example.com",
  "next_page_uri": "https://example.com",
  "page": 42,
  "page_size": 42,
  "previous_page_uri": "https://example.com",
  "start": 42,
  "uri": "https://example.com"
}