Sign in
Incoming Phone Numbers

List All Incoming Phone Numbers

The ability to read all of the IncomingPhoneNumbers that are associated with your SignalWire account. This will be returned as a list of IncomingPhoneNumbers.

Permissions

The API token must include the following scopes: Numbers.

get/Accounts/{AccountSid}/IncomingPhoneNumbers

Path parameters

AccountSidstring uuid required

The unique identifier for the account that is associated with this phone number.

Query parameters

Betaboolean

New numbers on SignalWire are marked as beta.

FriendlyNamestring

A formatted version of the number.

Example:310-338-6745
Origin'signalwire' | 'hosted'

The origin of the phone number. SignalWire numbers are denoted as signalwire while hosted numbers are denoted as hosted.

Example:origin
PhoneNumberstring

The incoming number in E.164 format.

Example:+13103386745

Response

OK

endstring

The end of the page.

num_pagesstring

Number of pages.

startstring

The start of page.

totalstring

The name of the object

account_sidstring

The unique identifier for this account.

uristring
first_page_uristring
next_page_uristring
previous_page_uristring
pageinteger
page_sizeinteger

Example response

{
  "end": "0",
  "incoming_phone_numbers": [
    {
      "account_sid": "b3877c40-da60-4998-90ad-b792e98472ac",
      "address_requirements": "none",
      "address_sid": "b3877c40-da60-4998-90ad-b792e98472ad",
      "api_version": "2010-04-01",
      "date_created": "Tue, 25 Sept 2018 23:00:00 +0000",
      "date_updated": "Wed, 26 Sept 2018 22:00:00 +0000",
      "emergency_address_sid": "null",
      "emergency_status": "active",
      "friendly_name": "310-338-6745",
      "identity_sid": "b3877c40-da60-4998-90ad-b792e98472ri",
      "origin": "origin",
      "phone_number": "+13103386745",
      "sid": "b3877c40-da60-4998-90ad-b792e98472pn",
      "sms_application_sid": "null",
      "sms_fallback_method": "POST",
      "sms_method": "POST",
      "status_callback": "example.com",
      "status_callback_method": "POST",
      "trunk_sid": "b3877c40-da60-4998-90ad-b792e98472tr",
      "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/IncomingPhoneNumbers/b3877c40-da60-4998-90ad-b792e98472pn.json",
      "voice_application_sid": "null",
      "voice_fallback_method": "POST",
      "voice_fallback_url": "example.com",
      "voice_method": "GET",
      "voice_url": "http://your-application.com/docs/voice.xml"
    }
  ],
  "num_pages": "3",
  "start": "0",
  "total": "3",
  "account_sid": "b3877c40-da60-4998-90ad-b792e98472ac"
}

Changes