Portability Lookup

MNP lookup

post

Introduction

Mobile Number Portability (MNP) lookup APIs allow you to discover information about a provided number by directly querying mobile number portability databases.

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 — whether the number has been ported

• 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]

Authorizations

default

X-API-KEYstringRequired

Body

application/json

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: 2025-09-01T09:06:46.285Z

mccstringOptionalExample: 234

mncstringOptionalExample: 15

msisdnstringRequiredExample: 4473481234567

omncstringOptionalExample: 15

portedbooleanOptionalExample: false

pricenumberRequiredExample: 0.0006

responseintegerRequiredExample: 0

401

401

text/plain

500

500

text/plain

post

/lookup/mnp

HTTPcURLJavaScriptPython

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

{
  "msisdn": [
    "4473481234567"
  ]
}

defaultwith_callback

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