NVS HTTP API

Response

Response

Once a request is done, a response similar to this is returned:

number=46731230000&mcc=276&mnc=04&roaming=N&ported=N&phoneOn=Y&lookupID=14474326362050010261&statusCode=0&statusDesc=SUCCESSFUL

 
The response values are separated by the & characters and are as follows:

Parameter NVS NVS plus Value
lookupID Y Y A reference ID for this lookup
number Y Y The number you queried for reference
statusCode Y Y Status of the lookup, see statusCode table below
statusDesc Y Y Descriptive name of status, see statusCode table below
mcc Y Y Mobile Country Code of current operator
mnc Y Y Mobile Network Code of current operator
phoneOn N Y Indicates whether number is currently in a phone that is switched on:

  • Y if phone is turned on
  • N if phone is turned off
  • U if status cannot be determined
roaming N Y Indicates whether number is currently roaming:

  • Y if number is roaming
  • N if number is located on the home network
  • U if status cannot be determined
ported N Y Indicates whether number is currently ported or on default network:

  • Y if number is ported
  • N if number is located on the default network
  • U if status cannot be determined
Status codes
Code Name Description
0 SUCCESSFUL Our sources indicate that the number provided is valid
1001 INVALID_LOGIN Incorrect Username or password or lookup is made from and IP not whitelisted for the bind
1003 BAD_NUMBER_FORMAT Non-numeric value provided
1004 NO_CREDIT Insufficient credits on account to do lookup
1005 THROTTLED You are trying to process more lookups per second than permitted. Please see your bind email for your allowed limit
1006 NO_COVERAGE NVS coverage for lookup country not available for your bind
1007 TIMED_OUT We did not get a reply for your query within a reasonable amount of time
9999 SYSTEM_ERROR System failure, or number provided is invalid

Only lookups with status code 0 are charged.

Get Started