USA Status Feature

v1 / v2

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 -I -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