RealtimeBulkPhone input

MNP lookup: number portability check

An MNP lookup tells you whether a mobile number was ported to another network and which network (MCC/MNC) serves it now. Any country, real time or bulk.

$0.002 per check real-time, $0.002 in bulk ($2.00 / $2.00 per 1,000). Unknowns are free. Try 20 numbers for real, free, after sign-up.

Start free

Last updated

The MNP lookup tells you whether a mobile number has been ported to another network, and which network it belongs to now. You get porting (ported or not_ported), the current network code (mcc_mnc) and the country of that network. It works for numbers from any country, in real time and in bulk jobs, and you pay only for conclusive answers. Unknown answers are free.

What is mobile number portability?

Mobile number portability (MNP) lets a subscriber keep their number when they move to another mobile network. Regulators introduced it to make switching easier. The United States required it for wireless numbers in the 100 largest metropolitan areas from 24 November 2003 (47 CFR 52.31). In the EU, Article 106 of the European Electronic Communications Code requires a ported number to be activated within one working day of the date agreed with the customer (Directive (EU) 2018/1972). Our MNP glossary entry and portability atlas cover the rules country by country.

Porting is common, not rare. In Brazil alone, 5,390,706 mobile numbers were ported in 2025, according to the regulator's open data (Anatel portability dataset, mobile service rows, file downloaded 3 November 2026). Our MNP atlas dataset lists launch years and porting times for the countries we could verify.

The side effect is that a number's prefix no longer tells you its network. The prefix shows which operator the range was allocated to. After a port, a different operator serves the number. Every system that guesses the network from the first digits is wrong for every ported number.

Why does porting matter?

  • SMS routing and cost. Many messaging routes and wholesale rates are set per destination network. Route a ported number by its prefix and the message can take a more expensive path, be rejected, or be delivered late. The current mcc_mnc lets you route by the network that actually serves the number. See number checks for OTP providers and SMS resellers.
  • Delivery analysis. When delivery rates drop for "one operator", ported numbers are often mixed into the wrong bucket. Grouping by the current network gives you honest per-network numbers.
  • Fraud checks. In a port-out scam, a criminal moves a victim's number to a network and SIM they control, then receives the victim's one-time passcodes. A number that shows ported when your records say it wasn't, or a current network that differs from the one you stored at sign-up, is a reason to add a step before a password reset or payout.
  • Data quality. Customer records often store the operator a number was bought from. Refreshing it with the current network keeps segmentation and support routing right.

A port by itself is not a risk signal. Millions of people switch operators. Treat ported as context, and act on a change compared with what you knew before.

MNP lookup or HLR lookup?

MNP lookup (mnp)HLR lookup (hlr)
Question it answersWas the number ported, and which network is it on now?Is the phone reachable right now, and on which network?
Portingporting: ported, not_portedported: true / false
Current networkmcc_mnc, countrynetwork, mcc_mnc, country
Live reachabilityNostatus: reachable, unreachable, invalid
RoamingNoroaming: true / false
PriceLower; see pricingHigher; see pricing
Typical useRouting, least-cost messaging, record refresh, port-change checksOTP pre-checks, cleaning lists of possibly disconnected numbers

If you need the network for routing, the MNP lookup is enough. If you also need to know whether the phone is switched on or the number is still assigned, use the HLR lookup, which includes the porting answer. There is no need to run both on the same number. The carrier lookup answers a third question, the line type (mobile, landline, VoIP).

What do you get back?

FieldTypeMeaning
attributes.portingenumported, not_ported or unknown (primary answer)
attributes.mcc_mncstringCode of the network the number belongs to now (MCC + MNC)
attributes.countrystringISO 3166-1 alpha-2 country of that network
registeredboolean or nulltrue when the answer is conclusive; null when not
status / reasonenum / stringcompleted, pending, unknown (e.g. UPSTREAM_TIMEOUT), unsupported_country
checked_at, cached, billed—When the answer was obtained, whether it came from cache, whether it was charged

The MNP lookup returns no subscriber data: no name, no SIM identifiers, no location. It describes where the number is routed, not who holds it.

How is it billed?

You pay per conclusive answer, at the price shown on the pricing page, in real time and in bulk jobs. ported and not_ported are conclusive answers and are billed. You're not charged for inconclusive results (unknown, unsupported country, timeout, invalid, duplicate). A number that the lookup can't place on any network, for example an invalid or unassigned number, comes back as unknown and is free.

Repeat checks of the same number inside the freshness window can come from your account's cache and are free (cached: true, billed: false). Send max_age: 0 to force a fresh check, for example right before a sensitive account change.

What are the limits?

  • Built for mobile numbers, in every country except sanctioned countries and regions, which answer unsupported_country for free.
  • Up to 100 numbers per real-time lookup and 50,000 per job, and up to 20 checks per request.
  • Requests that look like sequential number ranges or generated e-mail lists are rejected (suspected_enumeration).
  • A check can come back as pending first when a network answers slowly. Poll the lookup, or use a bulk job.
  • The answer describes the number at the time of the check. Numbers can be ported again later, so refresh stored results before decisions that depend on them.

Country guides

Before you check numbers from a country, our guides explain how porting works and which prefixes still identify a network: United States, Germany, Australia, Bangladesh, Nepal, Sri Lanka, Thailand, Vietnam, Malaysia, Kenya, Colombia. The full list is in phone numbers by country.

How do you use it responsibly?

Porting data describes a person's phone number. Check only numbers you have a lawful reason to process, such as customers, sign-ups and contacts who gave you their number. Don't use it to profile people or for eligibility decisions like credit, housing or employment. The acceptable use policy applies, and people can object to checks of their number through the opt-out form.

Example request

With a test key, +447700900001 returns not_ported, …006 returns ported, …003 returns unknown, …004 is pending and then not_ported, and …005 returns unsupported_country. See test mode.

curl https://api.mobilevalidate.com/v1/lookup \
  -H "Authorization: Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym" \
  -H "Content-Type: application/json" \
  -d '{"numbers":["+447700900006"],"checks":["mnp"]}'

Runs as pasted with the public sandbox key, which answers the test values only. In the SDKs, omit the key to use MOBILEVALIDATE_API_KEY.

Response (excerpt, test mode: the first item of results):

JSON
{
  "kind": "phone",
  "input": "+447700900006",
  "e164": "+447700900006",
  "country": "GB",
  "number_status": "valid",
  "checks": {
    "number.mnp": {
      "service": "number.mnp",
      "status": "completed",
      "registered": true,
      "attributes": {
        "porting": "ported",
        "mcc_mnc": "23410",
        "country": "GB"
      },
      "confidence": "high",
      "confidence_score": 0.99,
      "checked_at": "2026-09-27T09:12:04.318Z",
      "cached": false,
      "age_seconds": 0,
      "billed": false,
      "reason": null,
      "poll_after_ms": null
    }
  },
  "test": true
}

In live mode, billed is true for this answer. Routing by the current network, and flagging a network change against what you stored:

JavaScript
const mnp = result.checks["number.mnp"];
if (mnp.status === "completed") {
  const route = routeFor(mnp.attributes.mcc_mnc); // your per-network routing table
  if (stored.mcc_mnc && stored.mcc_mnc !== mnp.attributes.mcc_mnc) {
    // the number moved since you last checked: add a step before a password reset or payout
  }
} else {
  // unknown, pending or unsupported_country: not billed; fall back to your default route
}

Try it now

Run it here with a test value: the console calls the live API from your browser with the public sandbox key and shows the real JSON and a plain-English verdict.

POST /v1/lookup

Public sandbox key · test values only · never billed

The sandbox answers the test values below. To check your own numbers for real, create a free account: your first 20 phone numbers and 10 e-mail addresses are free.

Test numbers
Test e-mails
Checks · phone · 1 selected

Pick a test value or press Run

Press Run or pick a test value above: the console sends a real request to the API with the public sandbox key and shows the answer here.

Check your own numbers: 20 phone numbers and 10 e-mail addresses are checked for real, free, after sign-up. Start free

checks: ["number.mnp"] · Realtime lookup via POST /v1/lookup. Every example runs as pasted: it uses the public sandbox key, which answers the test values for free. In the SDKs, omit the key to use MOBILEVALIDATE_API_KEY.

curl https://api.mobilevalidate.com/v1/lookup \
  -H "Authorization: Bearer mv_test_publicSandboxn9ZgneuhR1B9CRfKG3fulym" \
  -H "Content-Type: application/json" \
  -d '{"numbers":["+447700900001"],"checks":["number.mnp"]}'

Real test-mode result for this check

checks["number.mnp"]
{
  "service": "number.mnp",
  "status": "completed",
  "registered": true,
  "attributes": {
    "porting": "not_ported",
    "mcc_mnc": "23415",
    "country": "GB"
  },
  "confidence": "high",
  "confidence_score": 0.99,
  "checked_at": "2026-09-27T09:12:04.318Z",
  "cached": false,
  "age_seconds": 0,
  "billed": false,
  "reason": null,
  "poll_after_ms": null
}

What you get

Fields of checks["number.mnp"], generated from the public service catalog.

FieldTypeMeaning
registeredboolean | nulltrue when data was found; null when unknown (not charged).
statusenumcompleted, pending, unknown, unsupported_country or failed.
checked_attimestampWhen the answer was obtained.
attributes.portingenumPorted to another network or not.ported · not_ported · unknown
attributes.mcc_mncstringCurrent network code (MCC+MNC).
attributes.countrystringISO country of the current network.

Frequently asked questions

What is an MNP lookup?

A check that tells you whether a mobile number has been ported away from the network its number range was allocated to, and which network it belongs to now, as an MCC/MNC code and a country. MNP stands for mobile number portability.

What does an MNP lookup cost?

It is priced per conclusive answer, in real time and in bulk jobs, and costs less than an HLR lookup. ported and not_ported are conclusive answers and are billed. unknown is free, including numbers the lookup can't place on a network. The pricing page shows the current price.

What is the difference between an MNP lookup and an HLR lookup?

The MNP lookup answers two questions: was the number ported, and which network is it on now. The HLR lookup asks the home network live and adds whether the phone is reachable right now and whether it is roaming. MNP is enough for routing; HLR is for reachability.

Does it tell me when the number was ported?

No. It returns ported or not_ported and the current network, not a porting date. A port on its own is normal: many people switch operators every year.

Which countries does it cover?

Mobile numbers from any country, except sanctioned countries and regions, which are never checked and never billed. When no conclusive answer is available for a number, the result is unknown and free.

Does it work for landlines?

It is built for mobile numbers. Use the carrier lookup to learn the line type first if your list mixes landlines, VoIP and mobiles.

How do I check if a phone number has been ported?

Send the number to the MNP lookup. It answers ported or not_ported and gives the network code (MCC/MNC) of the network that serves the number now. The prefix can't tell you this, because a ported number keeps the prefix of the operator it came from.

Is there a free number portability (MNP)?

Yes, to try it on your own data: create a free account and check up to 20 phone numbers for real on the dashboard's Try it page, at no cost. Test mode with documented test values is free and unlimited. After that, a number portability (MNP) costs $0.002 per check in real time ($2.00 per 1,000) and $0.002 in bulk jobs ($2.00 per 1,000), paid from prepaid credit. Unknown and other inconclusive results are always free.

All articles

Add Number portability (MNP) to your stack

Create a free MobileValidate account: approved automatically, usually within 10–15 minutes. Number portability (MNP): $0.002 per check real-time, $0.002 in bulk ($2.00 / $2.00 per 1,000).

Free to start: check 20 phone numbers and 10 e-mail addresses for real on your account, plus an unlimited test mode. You pay only for conclusive answers, from $20.