Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Inbound Processing Region API - PhoneNumber


In the context of the Inbound Processing Region API, a PhoneNumber resource represents the routing configuration for a particular IncomingPhoneNumber.

By adjusting the value of the voice_region property, you can control which Twilio Region will process and store data related to inbound calls for the phone number.

(warning)

Warning

Changes to this resource may take up to 5 minutes to take effect.


PhoneNumber Properties

phonenumber-properties page anchor
Resource properties
phone_numbertype: stringNot PII

The phone number in E.164 format


urltype: string<URI>Not PII

The absolute URL of the resource.


sidtype: SID<QQ>Not PII

A 34 character string that uniquely identifies the Inbound Processing Region assignments for this phone number.


account_sidtype: SID<AC>Not PII

The unique SID identifier of the Account.


friendly_nametype: stringNot PII

A human readable description of the Inbound Processing Region assignments for this phone number, up to 64 characters.


voice_regiontype: stringNot PII

The Inbound Processing Region used for this phone number for voice.


date_createdtype: string<DATE TIME>Not PII

The date that this phone number was assigned an Inbound Processing Region, given in ISO 8601 format.


date_updatedtype: string<DATE TIME>Not PII

The date that the Inbound Processing Region was updated for this phone number, given in ISO 8601 format.


Fetch a PhoneNumber's current Inbound Processing Region configuration

fetch-a-phonenumbers-current-inbound-processing-region-configuration page anchor
GET https://routes.twilio.com/v2/PhoneNumbers/{PhoneNumber}

Parameters

fetch-parameters page anchor
URI parameters
PhoneNumbertype: stringNot PII
Path Parameter

The phone number in E.164 format

Fetch a PhoneNumber's current Inbound Processing Region configuration

fetch-a-phonenumbers-current-inbound-processing-region-configuration-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.routes.v2.phoneNumbers('+18001234567')
_10
.fetch()
_10
.then(phone_number => console.log(phone_number.friendlyName));

Output

_10
{
_10
"phone_number": "+18001234567",
_10
"url": "https://routes.twilio.com/v2/PhoneNumbers/+18001234567",
_10
"sid": "QQXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"friendly_name": "friendly_name",
_10
"voice_region": "au1",
_10
"date_created": "2015-07-30T20:00:00Z",
_10
"date_updated": "2015-07-30T20:00:00Z"
_10
}


Update a PhoneNumber's Inbound Processing Region configuration

update-a-phonenumbers-inbound-processing-region-configuration page anchor
POST https://routes.twilio.com/v2/PhoneNumbers/{PhoneNumber}

URI parameters
PhoneNumbertype: stringNot PII
Path Parameter

The phone number in E.164 format


Request body parameters
VoiceRegiontype: stringNot PII

The Inbound Processing Region used for this phone number for voice


FriendlyNametype: stringNot PII

A human readable description of this resource, up to 64 characters.

Update a PhoneNumber's Inbound Processing Region configuration

update-a-phonenumbers-inbound-processing-region-configuration-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.routes.v2.phoneNumbers('+18001234567')
_10
.update({voiceRegion: 'au1'})
_10
.then(phone_number => console.log(phone_number.voiceRegion));

Output

_10
{
_10
"phone_number": "+18001234567",
_10
"url": "https://routes.twilio.com/v2/PhoneNumbers/+18001234567",
_10
"sid": "QQXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"friendly_name": "friendly_name",
_10
"voice_region": "au1",
_10
"date_created": "2015-07-30T20:00:00Z",
_10
"date_updated": "2015-07-30T20:00:00Z"
_10
}


Rate this page: