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. Update - January 22nd, 2007 - The URLs have been updated - to use the International Phone ID, please update the URLs you call to the ones below.

URLs

• Secure (HTTPS)
  • Primary Server: https://www.maxmind.com/app/phone_id_http
  • Backup Server: https://www2.maxmind.com/app/phone_id_http
• Regular (HTTP)
  • Primary Server: http://www.maxmind.com/app/phone_id_http
  • Backup Server: http://www2.maxmind.com/app/phone_id_http

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