Validation API

Validation API

Use this service to check the validity of an AREA-CODE

URL

https://www.callfire.com/cloud/1/utils/getNumberDetails?npanxs=AREA_CODE&apikey=YOUR_API_KEY

HTTP Method

GET

Content Type

text/plain

Parameters

• apikey: Required. This is your account api key.
• npanxs: Required. This is the Area Code that you wish to validate.

Response

Content-Type = application/xml

If there are no hits it will return you XML that looks like this:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<numberDetailsResponse>
	<description>Transaction successful</description>
	<successful>true</successful>
	<resultCount>0</resultCount>
</numberDetailsResponse>

If there are hits, you'll get something like:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<numberDetailsResponse>
	<description>Transaction successful</description>
	<successful>true</successful>
	<areaCode>
		<city>ANAHEIM</city>
		<country>US</country>
		<county>ORANGE</county>
		<npa>949</npa>
		<nxs>200</nxs>
		<state>CA</state>
		<timezone>-8</timezone>
		<zipcode>92802</zipcode>
	</areaCode>
	<areaCode>
		<city>ANAHEIM</city>
		<country>US</country>
		<county>ORANGE</county>
		<npa>949</npa>
		<nxs>200</nxs>
		<state>CA</state>
		<timezone>-8</timezone>
		<zipcode>92806</zipcode>
	</areaCode>
	<resultCount>2</resultCount>
</numberDetailsResponse>

System Errors will show up like this:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<numberDetailsResponse>
	<description>Bad API key</description>
	<successful>false</successful>
	<resultCount>-9</resultCount>
</numberDetailsResponse>