USA Status Feature
Overview
Retrieve the status of a USA or US Territories MOBILE telephone number if the telephone number is detected as a USA or US Territories mobile telephone number.
The US Territories are:
Puerto Rico
Guam
US Virgin Islands
We will translate the status for the telephone number to our standard live_status field and include an additional output field usa_status to indicate that this optional parameter was turned on.
IMPORTANT - This feature is only available for mobile numbers. If the number entered is identified as a non mobile number NOT_AVAILABLE_NETWORK_ONLY will be returned in the live_status response field.
Additional Charging
There is an additional 1 credit charge to attempt to check the status of a USA or US Territories mobile telephone number.
Therefore:
The total charge to lookup a telephone number when the telephone number is a USA or US Territories telephone number and the number is identified as a mobile number is 2 credits.
The total charge to lookup a telephone number when the telephone number is a USA or US Territories telephone number and the number is NOT identified as a mobile number is 1 credit.
The total charge to lookup a telephone number and the number is not identified as belonging to the USA or US Territories and the usa_status is requested is 1 credit.
Curl Example With USA Status Requested
curl -H "Content-Type: application/json" -X POST -d `{"api_key": "your_api_key_here", "api_secret": "your_api_secret_here", "requests": [{"telephone_number": "441133910781", "usa_status": "YES"}]}`
https://api.hlrlookup.com/apiv2/hlr