« Back to the developer index
The Geo API
The Geo API provides a simple way to find the location of a phone number. Results are given with their estimated level of accuracy, either 'accurate', 'questionable', 'best guess', or 'general area' based on factors such as record age, or whether a known record was used to find the result.
The request to our API is a standard HTTP GET request as follows:
http://api.reverseuk.com/geolookup.php?format=FORMAT&key=APIKEY&q=PHONE
Parameters
format (required)
valid options are json, xml, text
key (required)
32 characters long, provided when you join the developer program
q (required)
valid United Kingdom phone number
Example Query Results
Text
http://api.reverseuk.com/geolookup.php?format=text&key=EXAMPLE&q=0292061111
result (tab separated)
(02) 9206 1111 \t questionable \t Sydney \t NSW \t 2000 \t Telstra Corporation Limited \t Sydney \t Local Service
JSON
http://api.reverseuk.com/geolookup.php?format=json&key=EXAMPLE&q=0292061111
result
{"phone":"(02) 9206 1111","match":"questionable","suburb":"Sydney","state":"NSW","zip":"2000","holder":"Telstra Corporation Limited","area":"Sydney","type":"Local Service"}
XML
http://api.reverseuk.com/geolookup.php?format=xml&key=EXAMPLE&q=0292061111
result
<?xml version="1.0" encoding="iso-8859-1"?><record><phone>(02) 9206 1111</phone><match>questionable</match><suburb>Sydney</suburb><state>NSW</state><zip>2000</zip><holder>Telstra Corporation Limited</holder><area>Sydney</area><type>Local Service</type></record>
API Support
Please contact support@reverseuk.com if you are having trouble implementing our API