Check out our High Performance Batch Processing API: Match and Enrich Data Using CSV/TSV Files as Input Data to our APIs Learn More

Global Telephone Number Verification Get Global Phone Number Information API


Description:
This API provides geographic information for a global telephone number provided in the input parameter, including city and country information, primary languages spoken, and mobile device identification.


Example of global phone number information responses.
Global Phone Country Region Primary City Primary Language Second Language Third Language Mobile Wealth
+496979550 Germany Hesse Frankfurt German Yes 2
39 051 225445 Italy Emilia-Romagna Bologna Italian 2
+1 707-944-2380 USA California Sonoma English 1
+61 3 9662 3900 Australia Victoria Melbourne English Yes 2
+852 1212 8888 Hong Kong Hong Kong Cantonese Mandarin English 3
+86 2043439999 China Guangdong Guangzhou Cantonese Mandarin 6
+15147335555 Canada Quebec Montreal French 3
Click here to use this API to easily enhance global phone number information to Cloud database tables.

Service API Endpoint:
https://api.interzoid.com/getglobalnumberinfo

Calling Structure:
https://api.interzoid.com/getglobalnumberinfo?license=[licensekey]&intlnumber=[international telephone number]

Optional Specification Examples:
OpenAPI Specification 3.1 JSON

Input Parameters:
License: Your Interzoid-issued license key
International Telephone Number: Global number including country code (note: not providing a country code will have unexpected results).

Output Parameters:
Country: Country where telephone number is originating
Region: Region where telephone number is originating. Region demarcation can vary by country
Primary City: Primary city from where telephone number is originating, which can include rural numbers
Language 1: Primary language spoken where telephone number is originating
Language 2: A second language for the area if relevant
Language 3: A third language for the area if relevant
Mobile: If "Yes", indicates the number is likely a mobile number (not yet available for North American numbers)
Wealth: A number from 1 to 9 indicating a general wealth (1=wealthiest) score for the area


Sample URL Query:
https://api.interzoid.com/getglobalnumberinfo?license=f8smc6s****&intlnumber=+496979550
Sample JSON Output:
{"Country":"Germany","Region":"Hesse","PrimaryCity":"Frankfurt","Language1":"German","Language2":"","Language3":"","Mobile":"","Wealth":"2","Code":"Success","Credits":47473}
You can also set a header value for your API License Key (*recommended for production environments):
Curl Example:
curl --header "x-api-key: f8smc6s****" "https://api.interzoid.com/getglobalnumberinfo?intlnumber=+4906979550"

Sample Code Showing Usage:
Github

Try the API interactively:
(API License Key will auto-populate if you have an account and are logged in. Otherwise, register for a free account.)


Login or register to obtain



Result Code:

Country:

Region:

Primary City:

Primary Language:

Second Language:

Third Language:

Mobile:

Wealth Rank:

Credits Remaining:


See this API in action with our Cloud Data Connect Web application, which uses the API to match entire datasets and database tables. You can run sample datasets without using any API credits.

Do you have custom requirements or are interested in on-premise solutions? Contact us at support@interzoid.com