NVS HTTP API

Samples

Samples

Below is a sample request for NVS or NVS plus.

http://nvshttp.fortytwotele.com/?username=USER&password=PASS&number=356123

Where:

  • USER is your NVS/NVS plus username;
  • PASS is your NVS/NVS plus password;
  • 356123 represents a number you wish to validate;

This call will check the given number and return a reply within the HTTP response body. Below is the response you would get for the above number, which means the number is invalid.

number=356123&lookupID=14474248506850010261&statusCode=9999&statusDesc=SYSTEM_ERROR

Where:

  • number is the number you checked
  • lookupID is a unique reference for your request
  • statusCode is a numerical value indicating the result (in this case, error or not a valid number)
  • statusDesc describes the status code

For a valid number, you would get different responses based on whether you are using NVS or NVS plus. For NVS, you would get:

number=xxxxxxxxx&mcc=278&mnc=01&lookupID=14476857771570010261&statusCode=0&statusDesc=SUCCESSFUL

In this case, statusCode is zero, and statusDesc is SUCCESSFUL, indicating the number appears to be a valid number.

For NVS plus, the response would include some additional information when available, including MCC/MNC, additional status and roaming information when available.

number=xxxxxxxxx&mcc=234&mnc=15&roaming=N&ported=N&phoneOn=Y&lookupID=14476854767320010261&statusCode=0&statusDesc=SUCCESSFUL
Get Started