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
Changes to this resource may take up to 5 minutes to take effect.
Property nameTypePIIDescription
The phone number in E.164 format
The absolute URL of the resource.
A 34 character string that uniquely identifies the Inbound Processing Region assignments for this phone number.
Pattern: ^QQ[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
The unique SID identifier of the Account.
Pattern: ^AC[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
A human readable description of the Inbound Processing Region assignments for this phone number, up to 64 characters.
The Inbound Processing Region used for this phone number for voice.
date_createdstring<date-time> The date that this phone number was assigned an Inbound Processing Region, given in ISO 8601 format.
date_updatedstring<date-time> The date that the Inbound Processing Region was updated for this phone number, given in ISO 8601 format.
GET https://routes.twilio.com/v2/PhoneNumbers/{PhoneNumber}
Property nameTypeRequiredPIIDescription
PhoneNumberstringrequired The phone number in E.164 format
_18// Download the helper library from https://www.twilio.com/docs/node/install
_18const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18// Find your Account SID and Auth Token at twilio.com/console
_18// and set the environment variables. See http://twil.io/secure
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = twilio(accountSid, authToken);
_18async function fetchPhoneNumber() {
_18 const phoneNumber = await client.routes.v2
_18 .phoneNumbers("+18001234567")
_18 console.log(phoneNumber.phoneNumber);
_10 "phone_number": "+18001234567",
_10 "url": "https://routes.twilio.com/v2/PhoneNumbers/+18001234567",
_10 "sid": "QQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10 "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_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"
POST https://routes.twilio.com/v2/PhoneNumbers/{PhoneNumber}
Property nameTypeRequiredPIIDescription
PhoneNumberstringrequired The phone number in E.164 format
Property nameTypeRequiredPIIDescription
VoiceRegionstringOptional The Inbound Processing Region used for this phone number for voice
FriendlyNamestringOptional A human readable description of this resource, up to 64 characters.
_18// Download the helper library from https://www.twilio.com/docs/node/install
_18const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18// Find your Account SID and Auth Token at twilio.com/console
_18// and set the environment variables. See http://twil.io/secure
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = twilio(accountSid, authToken);
_18async function updatePhoneNumber() {
_18 const phoneNumber = await client.routes.v2
_18 .phoneNumbers("+18001234567")
_18 .update({ voiceRegion: "au1" });
_18 console.log(phoneNumber.voiceRegion);
_10 "phone_number": "+18001234567",
_10 "url": "https://routes.twilio.com/v2/PhoneNumbers/+18001234567",
_10 "sid": "QQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10 "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_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"