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

uri string
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 [

beta boolean

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.

voice boolean

Whether or not voice is enabled on the number.

SMS boolean

Whether or not SMS is enabled on the number.

MMS boolean

Whether or not MMS is enabled on the number.

fax boolean

Whether or not fax is enabled on the number.

friendly_name string

A formatted version of the number.

Example: 253-218-6751

iso_country string

The ISO country code of the number.

Example: US

lata stringnullable

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

Example: null

latitude string

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

Example: null

longitude string

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

Example: null

phone_number string

The number in E.164 format.

Example: +12532186751

postal_code string

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

Example: null

rate_center string

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

Example: AUBURN

region string

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"
    }
  ]
}