Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

One Lookup

OneLookup

post

Introduction

OneLookup is a single endpoint that combines a real-time (HLR) query with a database fallback, letting you validate one or many numbers in a single call.

For each MSISDN you submit it returns the number's country and network information, portability status and — when a live query succeeds — its real-time availability via a GSM error code.

Each response contains:

  • date — time when the request was executed (ISO8601)

  • msisdn — the number for which the response has been returned

  • live — whether the result was obtained from a live (real-time) query

  • numberType — the type of number (e.g. Mobile)

  • mcc — Mobile country code (learn more)

  • mnc — Mobile network code the number currently belongs to

  • omnc — Original network code (the network the number originally belonged to)

  • spid — Service provider ID of the current network

  • oSpid — Service provider ID of the original network

  • imsi — IMSI (learn more); returned when available

  • originalNetwork (the network to which the number originally belonged)

    • countryName

    • countryPrefix

    • networkName

  • portedNetwork (the network to which the number is currently ported); returned when ported is true

    • countryName

    • countryPrefix

    • networkName

  • ported — denotes whether the number has been ported

  • 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 procurement@bind.hr

3

Out of balance

Contact procurement@bind.hr

4

Throttled

Contact procurement@bind.hr

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 procurement@bind.hr

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
X-API-KEYstringRequired
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
datestringRequiredExample: 2026-07-03T07:12:23.479Z
msisdnstringRequiredExample: 385981315559
livebooleanOptionalExample: true
numberTypestringOptionalExample: Mobile
mccstringOptionalExample: 219
mncstringOptionalExample: 01
omncstringOptionalExample: 01
spidintegerOptionalExample: 67
oSpidintegerOptionalExample: 67
imsistringOptionalExample: 234308419716505
portedbooleanOptionalExample: false
gsmErrorCodeintegerOptionalExample: 0
pricenumberRequiredExample: 0.0002
responseintegerRequiredExample: 0
post/lookup/onelookup

Last updated