Voice Geo Permissions

You can maintain custom geo permissions for each of your subaccounts. For example, you can enable calls to specific countries when using a specific subaccount and disable the same countries when using a different subaccount. You can also reset subaccount geo permissions to the default setting. 

Step 1: Navigate to the Voice Geo Permissions page and select the subaccount from the Account menu drop-down.

Step 2: After selecting the subaccount, click on Remove override to set default preferences.

For more information, see our detailed reference documentation.

You can see whether a call was blocked due to voice geo permissions by checking the hangup cause in your voice logs. You can filter logs using the following hangup causes:

• Destination Country Barred (Code 2030)
• Destination Number Barred (Code 2040)

Calls to blocked countries

API calls to blocked countries are rejected with HTTP response code 403 and the error message Calls to this destination country are barred.

Calls initiated with the Dial XML are dropped automatically. The hangup cause listed in the CDR for such calls is set to Destination Country Barred (Code 2030).

Learn more about Plivo hangup causes in our documentation.

Calls to blocked numbers

API calls to blocked numbers are rejected with HTTP response code 403 and the error message Calls to this destination number are barred.

Calls initiated with the Dial XML are dropped automatically. The hangup cause listed in the CDR for such calls is set to Destination Number Barred (Code 2040). 

For more information on outbound voice geo permissions, see our reference documentation.

Plivo voice geo permissions are supported only via the Plivo console.

Plivo disables by default countries with a high risk of call fraud. To see countries disabled by default, visit the Voice Geo Preferences page in the Plivo console. Under the Geo Permissions For Outbound Calls section, select Filter Countries > Status > Disabled, then click Apply.

The following countries have the highest risk of call fraud. All are disabled by default.

Afghanistan
Albania
Austria
Azerbaijan
Belarus
Bulgaria
Cambodia
Cameroon
Croatia
Cuba
Democratic Republic of the Congo
Ecuador
Georgia
Greenland
Guinea
Haiti
Honduras
Ivory Coast
Libya
Madagascar
Maldives
Morocco
Niger
North Korea
Papua New Guinea
Republic of the Congo
Samoa
Serbia
Sierra Leone
Solomon Islands
Somalia
South Sudan
Tanzania
Zimbabwe

Voice geo permissions are effective for calls made using both REST APIs and Dial XML. This post explains how you can see whether a call was blocked due to voice geo permissions.

Default preferences are applied to all calls initiated from the main account and all subaccounts unless they're explicitly overridden for a subaccount. To specify preferences for a subaccount, go to Voice > Geo Permissions. Select the subaccount from the Account drop-down menu, specify your preferences, and click Save Changes.

For more information, see our documentation.

Voice geo permissions let you enable or disable outbound calls to specific countries from the Plivo console. Our documentation provides detailed information on how they work.

Geo permissions take effect immediately once the settings are saved and are applied to all calls placed via REST APIs and Dial XML.

You can minimize the risk of toll fraud and international revenue-sharing fraud by closing voice routes to premium phone numbers from your Plivo account. We recommend that you disable outbound calls to premium numbers unless your use case depends on it.

You must be an admin user to block calls to premium phone numbers in the console. Go to Voice > Geo Permissions > High Risk Permissions. Tick the check box at the top of the third column and click Save Changes to update your preferences.

Enabling this feature blocks calls to premium numbers across all countries.

On the Plivo console, go to Voice > Geo Permissions > Country Permissions to block outbound calls to specific countries.

You can override geo permissions for individual subaccounts to restrict access at a granular level.

Yes. As an example, suppose you want to allow calls and SMS messages only to numbers in the North American Numbering Plan (NANP).

The country code for the 20 countries in the NANP (which includes the US, Canada, and countries in the Caribbean) is +1. You can find lists of area codes online. The Plivo prefix consists of the numbers of the country code plus the area code: 1406 for Montana, for example.

Allow the prefixes you want to include in your application, and have your code check to make sure that any attempts to message or call any other prefix will not be completed.

You can achieve the same results for outbound calls or messages for entire countries by going to the Plivo console, to Voice or SMS > Geo Permissions > Country Permissions, and ticking checkboxes to enable or disable calls for specific countries.