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

DialingPermissions Country Resource

Voice dialing permissions are organized by country and identified by the country's ISO(link takes you to an external page) code.

DialingPermissions Country properties

dialingpermissions-country-properties page anchor
Property nameTypeRequiredDescriptionChild properties
iso_codestring<iso-country-code>Optional
Not PII

The ISO country code(link takes you to an external page).

namestringOptional
Not PII

The name of the country.

continentstringOptional
Not PII

The name of the continent in which the country is located.

country_codesarray[string]Optional
Not PII

The E.164 assigned country codes(s)(link takes you to an external page)

low_risk_numbers_enabledbooleanOptional
Not PII

Whether dialing to low-risk numbers is enabled.

high_risk_special_numbers_enabledbooleanOptional
Not PII

Whether dialing to high-risk special services numbers is enabled. These prefixes include number ranges allocated by the country and include premium numbers, special services, shared cost, and others

high_risk_tollfraud_numbers_enabledbooleanOptional
Not PII

Whether dialing to high-risk toll fraud(link takes you to an external page) numbers is enabled. These prefixes include narrow number ranges that have a high-risk of international revenue sharing fraud (IRSF) attacks, also known as toll fraud(link takes you to an external page). These prefixes are collected from anti-fraud databases and verified by analyzing calls on our network. These prefixes are not available for download and are updated frequently

urlstring<uri>Optional
Not PII

The absolute URL of this resource.

linksobject<uri-map>Optional
Not PII

A list of URLs related to this resource.

Fetch a DialingPermissions Country resource

fetch-a-dialingpermissions-country-resource page anchor
GET https://voice.twilio.com/v1/DialingPermissions/Countries/{IsoCode}

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
IsoCodestring<iso-country-code>required
Not PII

The ISO country code(link takes you to an external page) of the DialingPermissions Country resource to fetch

Fetch a DialingPermissions Country resource

fetch-a-dialingpermissions-country-resource-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18
_18
// Find your Account SID and Auth Token at twilio.com/console
_18
// and set the environment variables. See http://twil.io/secure
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function fetchDialingPermissionsCountry() {
_18
const country = await client.voice.v1.dialingPermissions
_18
.countries("US")
_18
.fetch();
_18
_18
console.log(country.isoCode);
_18
}
_18
_18
fetchDialingPermissionsCountry();

Output

_15
{
_15
"iso_code": "US",
_15
"name": "United States/Canada",
_15
"country_codes": [
_15
"+1"
_15
],
_15
"continent": "NORTH_AMERICA",
_15
"low_risk_numbers_enabled": false,
_15
"high_risk_special_numbers_enabled": false,
_15
"high_risk_tollfraud_numbers_enabled": false,
_15
"url": "https://voice.twilio.com/v1/DialingPermissions/Countries/US",
_15
"links": {
_15
"highrisk_special_prefixes": "https://voice.twilio.com/v1/DialingPermissions/Countries/US/HighRiskSpecialPrefixes"
_15
}
_15
}

Read multiple DialingPermissions Country resources

read-multiple-dialingpermissions-country-resources page anchor
GET https://voice.twilio.com/v1/DialingPermissions/Countries

Query parameters

query-parameters page anchor
Property nameTypeRequiredPIIDescription
IsoCodestring<iso-country-code>Optional
Not PII

Filter to retrieve the country permissions by specifying the ISO country code(link takes you to an external page)

ContinentstringOptional
Not PII

Filter to retrieve the country permissions by specifying the continent

CountryCodestringOptional
Not PII

Filter the results by specified country codes(link takes you to an external page)

LowRiskNumbersEnabledbooleanOptional
Not PII

Filter to retrieve the country permissions with dialing to low-risk numbers enabled. Can be: true or false.

HighRiskSpecialNumbersEnabledbooleanOptional
Not PII

Filter to retrieve the country permissions with dialing to high-risk special service numbers enabled. Can be: true or false

HighRiskTollfraudNumbersEnabledbooleanOptional
Not PII

Filter to retrieve the country permissions with dialing to high-risk toll fraud(link takes you to an external page) numbers enabled. Can be: true or false.

PageSizeintegerOptional
Not PII

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Minimum: 1Maximum: 1000
PageintegerOptional
Not PII

The page index. This value is simply for client state.

Minimum: 0
PageTokenstringOptional
Not PII

The page token. This is provided by the API.

Read multiple DialingPermissions Country resources

read-multiple-dialingpermissions-country-resources-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18
_18
// Find your Account SID and Auth Token at twilio.com/console
_18
// and set the environment variables. See http://twil.io/secure
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function listDialingPermissionsCountry() {
_18
const countries = await client.voice.v1.dialingPermissions.countries.list({
_18
limit: 20,
_18
});
_18
_18
countries.forEach((c) => console.log(c.isoCode));
_18
}
_18
_18
listDialingPermissionsCountry();

Output

_28
{
_28
"content": [
_28
{
_28
"iso_code": "US",
_28
"name": "United States/Canada",
_28
"country_codes": [
_28
"+1"
_28
],
_28
"continent": "NORTH_AMERICA",
_28
"low_risk_numbers_enabled": false,
_28
"high_risk_special_numbers_enabled": false,
_28
"high_risk_tollfraud_numbers_enabled": false,
_28
"url": "https://voice.twilio.com/v1/DialingPermissions/Countries/US",
_28
"links": {
_28
"highrisk_special_prefixes": "https://voice.twilio.com/v1/DialingPermissions/Countries/US/HighRiskSpecialPrefixes"
_28
}
_28
}
_28
],
_28
"meta": {
_28
"first_page_url": "https://voice.twilio.com/v1/DialingPermissions/Countries?IsoCode=US&PageSize=50&Page=0",
_28
"key": "content",
_28
"next_page_url": null,
_28
"page": 0,
_28
"page_size": 50,
_28
"previous_page_url": null,
_28
"url": "https://voice.twilio.com/v1/DialingPermissions/Countries?IsoCode=US&PageSize=50&Page=0"
_28
}
_28
}

Rate this page: