Sign in
Incoming Phone Numbers

List all Incoming Phone Numbers

List all incoming phone numbers.

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

PhoneNumberstring

Only show numbers that match this pattern.

FriendlyNamestring

Only show numbers with this friendly name.

Betaboolean

Only show numbers that are marked as beta.

Originstring

Only show numbers that match this origin.

Response

The request has succeeded.

uristring

The URI of the current page.

first_page_uristring

The URI of the first page.

next_page_uristring

The URI of the next page.

previous_page_uristring nullable

The URI of the previous page.

pageinteger

The current page number.

page_sizeinteger

The number of items per page.

account_sidstring

The unique identifier for this account.

Example response

{
  "uri": "/api/laml/2010-04-01/Accounts?Page=0&PageSize=50",
  "first_page_uri": "/api/laml/2010-04-01/Accounts?Page=0&PageSize=50",
  "next_page_uri": "/api/laml/2010-04-01/Accounts?Page=1&PageSize=50",
  "page_size": 50,
  "account_sid": "b3877c40-da60-4998-90ad-b792e98472ac",
  "incoming_phone_numbers": [
    {
      "account_sid": "b3877c40-da60-4998-90ad-b792e98472ac",
      "address_sid": "b3877c40-da60-4998-90ad-b792e98472ad",
      "api_version": "2010-04-01",
      "capabilities": {
        "Voice": true,
        "SMS": true,
        "MMS": true,
        "Fax": true
      },
      "date_created": "Tue, 25 Sept 2018 23:00:00 +0000",
      "date_updated": "Wed, 26 Sept 2018 22:00:00 +0000",
      "friendly_name": "310-338-6745",
      "identity_sid": "b3877c40-da60-4998-90ad-b792e98472ri",
      "phone_number": "+13103386745",
      "sid": "b3877c40-da60-4998-90ad-b792e98472pn",
      "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_fallback_method": "POST",
      "voice_fallback_url": "example.com",
      "voice_method": "GET",
      "voice_url": "http://your-application.com/docs/voice.xml"
    }
  ]
}

Changes