Realtime Lookup

Realtime Lookup

post

Introduction

Real-time lookup APIs allow you to discover live information for a provided number.

By using the real-time lookup APIs you ensure the number you are querying is valid, along with information related to the number itself, such as the country and the network to which it belongs.

Each response contains:

  • 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 the number originally belonged)

    • countryName

    • countryPrefix

    • networkName

  • portedNetwork (the network to which the number is currently 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 result code (see below)

Response values

Value
Description
Action

0

Success

✈️

1

General error

Repeating the request won't yield a 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

REACHABLE

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

Authorizations
Body
msisdnstring[]Required

A list of MSISDNs to look up.

callback_urlstring · uriOptional

An optional URL to receive a callback with the results.

Responses
200

200

application/json
post
/lookup/hlr
POST /lookup/hlr HTTP/1.1
Host: number-api.bind.hr
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "msisdn": [
    "4473481234567"
  ]
}
[
  {
    "date": "2025-09-01T09:06:46.285Z",
    "mcc": "234",
    "mnc": "15",
    "msisdn": "4473481234567",
    "omnc": "15",
    "originalNetwork": {
      "countryName": "United Kingdom",
      "countryPrefix": "44",
      "networkName": "Vodafone UK"
    },
    "gsmErrorCode": 0,
    "ported": false,
    "price": 0.0006,
    "response": 0
  }
]
NextPortability Lookup