Phone Verification Requests & Response Codes

Here is an example of our phone verification service API URL:
phone verification api call example

You would simply replace the highlighted data with the information you want to verify, and your own personal account’s API key and trusted domain. It is also important to identify if you want your response results to come back in XML or JSON format.

Each Parameter in the Phone Validation API Request
Phone (required): This parameter contains the phone number that you want to verify.
Type (required): You can set the type to either JSON or XML
APIkey (required): This is where you insert your API key. You must have an account with us to get access to your APIkey
Domain (required): This is where you insert your trusted domain. If you make an api call with an unauthorized domain you will get a 503 error unless tests are available
Secret Key (optional): You can use the secret key to add new trusted domains via the API, this is mostly used by our reseller clients.

Each Tag in the Phone Validation Response

phone tags

  • <value>
    This is the phone number entered by the user
  • <error>
    This helps you identify if there was an error with your request. When this tag displays “0” then there is no error. Anything else in this tag will indicate there is a problem with the request.
  • <status>
    This tag lets you know if the phone number supplied was either valid or invalid.
  • <response code>
    The response code helps you identify the results of your request when you check a phone number.
  • <message>
    The message tag helps provide more details that help explain the response code.
  • <duration>
    This tag indicates the total execution time for the request.
  • <areacode>
    This is the area code of the phone number
  • <prefix>
    This is the first 3 digits of the phone number
  • <suffix>
    This is the last 4 digits of the phone number
  • <latitude>
    Represents the latitude associated with the phone number’s city/state
  • <longitude>
    Represents the longitude associated with the phone number’s city/state
  • <extension>
    Represents the extension associated with the phone number
  • <city>
    The city the phone number is linked to
  • <state>
    The state the phone number is linked to
  • <country>
    The country the phone number is associated with
  • <timezone>
    The time zone that the phone number’s area code belongs to
  • <exchange_type>
    Helps you identify if the phone number you verified is a landline, cellphone, or VOIP phone number.
  • <phone_type>
    This helps you verify if the phone number belongs to a person or a business. It will display business, or residential.