MNP lookup API

Mobile numbers move between networks. An MNP lookup tells you which network a number belongs to now, so you can route and price each message or call correctly.

What an MNP lookup tells you

  • The network the number belongs to today, even if it has moved from another one.
  • The name of that network, with its MCC and MNC codes.
  • Whether the number has a valid format for its country.

MNP stands for mobile number portability: the right of a subscriber to keep their number when they change network. Because of it, the prefix of a number no longer tells you its network.

MNP or HLR?

  • MNP lookup: which network a number belongs to now. It does not tell you whether the number is live or switched on.
  • HLR lookup: the status of the number, such as active, absent or unknown to the network, and the network serving it.

If you route or price traffic by network, an MNP lookup is usually enough. If you want to remove dead numbers from a list before you call or text, use an HLR lookup.

Who it is for

SMS and messaging platforms, carriers and resellers that route traffic by network, and teams that need the current network of each number on a list.

Prices

You pay per lookup, and the price depends on the country. The minimum top-up is €5, with no monthly fee.

See MNP prices by country

How to run lookups

  • One number: a single API request returns the result straight away.
  • Batches: send up to 1,000 numbers in one API request and collect the results when they are ready, or have them sent to your webhook.
  • Files: upload up to 50,000 numbers in the portal and download the results as a CSV file.

Read the API documentation for requests and response fields.

Before you rely on it

Results depend on the portability data each country makes available, so coverage differs by country. Check the pricing page for the countries we serve, and run a sample from your own numbers first.

Create an Account

HLR lookup by country: Australia · UK · South Africa · Türkiye