Introduction

Live lookup resolving API's are allowing you to discover live information in regard to the provided number.

By using the live lookup resolving API's you make sure that the number you are querying is valid, along with information related to the number itself, such as country and the network to which it belongs.

Example response

[
  {
    "date": "2023-07-11T14:24:03.403Z",
    "gsmErrorCode": 0,
    "imsi": "404193230250924",
    "mcc": "404",
    "mnc": "19",
    "msisdn": "919841234567",
    "originalNetwork": {
      "countryName": "India",
      "countryPrefix": "91",
      "networkName": "Vodafone Idea"
    },
    "ported": false,
    "response": 0
  }
]

Each response contains the following information:

  • date - time when the request was executed (ISO8601)
  • msisdn - the number for which the response has been returned
  • mcc - Mobile country code (learn more)
  • mnc - Mobile network code (learn more)
    • the mobile network code to which the number currently belongs
  • omnc - Original network code
    • Returned in case the ported flag is true
  • originalNetwork (The network to which number belongs)
    • countryName
    • countryPrefix
    • networkName
  • portedNetwork (The network to which the number belongs when ported)
    • countryName
    • countryPrefix
    • networkName
  • ported - Denotes whether the number has been ported
  • imsi - IMSI (learn more)
  • gsmErrorCode - error code related to user availability (see below)
  • price - The price for this request
  • response - The response indicating the success or failure (see below)

Response values

ValueDescriptionAction
0Success✈️
1General errorRepeating the request won't yield different result
2Pricing not setContact [email protected]
3Out of balanceContact [email protected]
4ThrottledContact [email protected]
5Invalid numberNumber length not valid
6Not resolvedNumber cannot be resolved due to missing coverage
7TimeoutNumber cannot be resolved due to timeout
8Missing permissionsContact [email protected]

GSM error codes

ECERROR DESCRIPTION
0DELIVERED
1UNKNOWN_SUBSCRIBER
5UNIDENTIFIED_SUBSCRIBER
9ILLEGAL_SUBSCRIBER
11TELESERVICE_NOT_PROVISIONED
13CALL_BARRED
21FACILITY_NOT_SUPPORTED
27ABSENT_SUBSCRIBER
31SUBSCRIBER_BUSY_FOR_MT_SMS
32DELIVERY_FAILURE
34SYSTEM_FAILURE
36UNEXPECTED_DATA_VALUE
37MEMORY_CAPACITY_EXCEEDED
38PREFIX_NOT_RESOLVED
39IMSI_BLACKLISTED
40DEST_ADDRESS_BLACKLISTED
41TIME_OUT
43INVALID_ORIGINATOR_ADDRESS
100GENERAL_ERROR
200EQUIPMENT_PROTOCOL_ERROR
201UNKNOWN_MSC
202CONGESTION_ERROR
203PARAMETER_MISSMATCH
204INITIATING_RELEASE
205POTENTIAL_VERSION_INCOMPATIBILITY
206REMOTE_NODE_NOT_REACHABLE
207MTP_FAILURE
208NETWORK_CONGESTION
209SIGNALLING_FAILURE
210ABNORMAL_MAP_DIALOG
211INVALID_PDU_FORMAT
300ABORTED_RETRY
301VALIDITY_PERIOD_EXPIRED
Language
Authorization
Header
Click Try It! to start a request and see the response here!