Search for available phone numbers that match your criteria.

GET 
/Accounts/:AccountSid/AvailablePhoneNumbers/:IsoCountry/Local

Search for Local AvailablePhoneNumbers.

Permissions

The API token must include the following scopes: Numbers.

Request

Path Parameters

AccountSid uuidrequired

The Project ID that uniquely identifies the Account to retrieve.

IsoCountry stringrequired

The ISO country code of the number.

Query Parameters

AreaCode string
Beta boolean
Contains string
ExcludeAllAddressRequired boolean
ExcludeForeignAddressRequired boolean
ExcludeLocalAddressRequired boolean
FaxEnabled boolean
InRegion string
MmsEnabled boolean
SmsEnabled boolean
VoiceEnabled boolean

Responses

200

OK

application/json

Schema

Schema

uristring
The URI for the API call.
Example: /api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US/Local

available_phone_numbers

object[]

Array [

betaboolean

New numbers on SignalWire are marked as beta. Possible values are true or false.

capabilities

object

Whether or not a number can receive calls and messages. Possible values are voice, SMS, MMS, and Fax. Each of these values have a boolean value of true or false.

voiceboolean

Whether or not voice is enabled on the number.

SMSboolean

Whether or not SMS is enabled on the number.

MMSboolean

Whether or not MMS is enabled on the number.

faxboolean

Whether or not fax is enabled on the number.

friendly_namestring

A formatted version of the number.

Example: 253-218-6751

iso_countrystring

The ISO country code of the number.

Example: US

latastringnullable

The LATA of the number. Only available for numbers in US and Canada.

Example: null

latitudestring

The latitude of the number. Only available for numbers in US and Canada.

Example: null

longitudestring

The longitude of the number. Only available for numbers in US and Canada.

Example: null

phone_numberstring

The number in E.164 format.

Example: +12532186751

postal_codestring

The postal/zip code of the number. Only available for numbers in US and Canada.

Example: null

rate_centerstring

The rate center of the number. Only available for numbers in US and Canada.

Example: AUBURN

regionstring

The state or province abbreviation of the number. Only available for numbers in US and Canada.

Example: WA

]

Example (from schema)

{
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/AvailablePhoneNumbers/US/Local",
  "available_phone_numbers": [
    {
      "beta": true,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": true,
        "fax": true
      },
      "friendly_name": "253-218-6751",
      "iso_country": "US",
      "lata": null,
      "latitude": null,
      "longitude": null,
      "phone_number": "+12532186751",
      "postal_code": null,
      "rate_center": "AUBURN",
      "region": "WA"
    }
  ]
}