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 | City | state | String | State | zip | String | Zipcode | countryname | String | Country name | latitude | Decimal number | Latitude | longitude | Decimal number | Longitude |