post https://number-api.bind.hr/lookup/hlr
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 returnedmcc
- 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 istrue
- Returned in case the
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 portedimsi
- IMSI (learn more)gsmErrorCode
- error code related to user availability (see below)price
- The price for this requestresponse
- The response indicating the success or failure (see below)
Response values
Value | Description | Action |
---|---|---|
0 | Success | ✈️ |
1 | General error | Repeating the request won't yield different result |
2 | Pricing not set | Contact [email protected] |
3 | Out of balance | Contact [email protected] |
4 | Throttled | Contact [email protected] |
5 | Invalid number | Number length not valid |
6 | Not resolved | Number cannot be resolved due to missing coverage |
7 | Timeout | Number cannot be resolved due to timeout |
8 | Missing permissions | Contact [email protected] |
GSM error codes
EC | ERROR DESCRIPTION |
---|---|
0 | DELIVERED |
1 | UNKNOWN_SUBSCRIBER |
5 | UNIDENTIFIED_SUBSCRIBER |
9 | ILLEGAL_SUBSCRIBER |
11 | TELESERVICE_NOT_PROVISIONED |
13 | CALL_BARRED |
21 | FACILITY_NOT_SUPPORTED |
27 | ABSENT_SUBSCRIBER |
31 | SUBSCRIBER_BUSY_FOR_MT_SMS |
32 | DELIVERY_FAILURE |
34 | SYSTEM_FAILURE |
36 | UNEXPECTED_DATA_VALUE |
37 | MEMORY_CAPACITY_EXCEEDED |
38 | PREFIX_NOT_RESOLVED |
39 | IMSI_BLACKLISTED |
40 | DEST_ADDRESS_BLACKLISTED |
41 | TIME_OUT |
43 | INVALID_ORIGINATOR_ADDRESS |
100 | GENERAL_ERROR |
200 | EQUIPMENT_PROTOCOL_ERROR |
201 | UNKNOWN_MSC |
202 | CONGESTION_ERROR |
203 | PARAMETER_MISSMATCH |
204 | INITIATING_RELEASE |
205 | POTENTIAL_VERSION_INCOMPATIBILITY |
206 | REMOTE_NODE_NOT_REACHABLE |
207 | MTP_FAILURE |
208 | NETWORK_CONGESTION |
209 | SIGNALLING_FAILURE |
210 | ABNORMAL_MAP_DIALOG |
211 | INVALID_PDU_FORMAT |
300 | ABORTED_RETRY |
301 | VALIDITY_PERIOD_EXPIRED |