USA Status Feature

v1 / v2

USA Status Feature

Overview

Retrieve the status of a USA MOBILE telephone number if the telephone number is detected as a USA mobile telephone number.

If the number is identified as belonging to a USA territory we CANNOT obtain the status. The USA 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 mobile telephone number.

Therefore:

  • The total charge to lookup a telephone number when the telephone number is a USA 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 when the telephone number is a US Territories telephone number and the number is 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