Implementation Guidelines for Telephone Number Identification

We provide automated access to our Telephone Number Identification (TNI) service using the HTTP protocol. This page describes the URLs and input and output fields for the TNI service.

While you can write your own code to access the HTTP service, we recommend using our PHP, Perl, Java, ASP and .NET APIs.

URLs

Secure (HTTPS)

  • Server: https://api.maxmind.com/app/phone_id_http

Regular (HTTP)

  • Server: http://api.maxmind.com/app/phone_id_http

A sample query is listed below:

https://api.maxmind.com/app/phone_id_http?phone=PHONE_NUMBER&l=YOUR_LICENSE_KEY_HERE

Any plus sign '+' must be URL escaped. That is you should replace '+' with '%2B' in PHONE_NUMBER.

Inputs

Field Description
phone Required Telephone number. For international numbers, be sure to include the leading "+" sign followed by the country code.
l Required License Key Obtain my license key

Outputs

Field Format Description
phoneType 1 digit code Code indicating the type of phone number (See code list)
refid 16 digit string Reference ID generated by MaxMind that references this phone ID request
err Human-readable string Error string
city String 都市
state String
zip String Zipcode
countryname String Country name
latitude Decimal number 緯度
longitude Decimal number 経度