Skip to content

Carrier lookup API for current network and porting

Send a mobile number and get the carrier serving it today, the carrier it was first issued to, and whether it was ported between them. 3 credits per lookup.

3 creditsValidateCSV bulkMCP
POST/v1/carrier-lookup
{
  "success": true,
  "data": {
    "phone_number": "+15125550142",
    "country": "US",
    "network_type": "mobile",
    "current_carrier": {
      "name": "Example Wireless",
      "mcc": "310",
      "mnc": "999"
    },
    "original_carrier": {
      "name": "Contoso Mobile",
      "mcc": "310",
      "mnc": "998"
    },
    "ported": true
  },
  "meta": {
    "credits_used": 3,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

current_carrier.nameCurrent carrierThe operator that serves the number now, after any port.
original_carrier.nameOriginal carrierThe operator that first held the number range.
portedPortedtrue when the number has moved away from its original carrier.
network_typeNetwork typeThe kind of network the number sits on, such as mobile.
current_carrier.mccMCCMobile country code for the current carrier.
current_carrier.mncMNCMobile network code for the current carrier, the value most routing tables key on.
countryCountryISO code of the country that issued the number.
[02/Capabilities]

What Carrier Lookup does

01

Portability data, not prefix guesses

A number's prefix only tells you who held the range when it was allocated. This lookup reads mobile number portability records, so the carrier you get is the one serving the number after any moves.

02

Original and current, side by side

Both carriers come back in the same response with a ported flag. Spot a ported number with one boolean, or compare the two names yourself.

03

MCC and MNC for routing tables

Carrier names change with mergers and rebrands. The numeric network codes are what messaging and voice platforms match on, so they are included in every result.

04

Lower cost than a live network query

No request goes to the serving network, which keeps the price at 3 credits. If you also need to know whether the handset is switched on, use HLR Lookup.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/carrier-lookup3 credits

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/carrier-lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+15125550142"}'
Endpoint
POST /v1/carrier-lookup
Base URL
https://api.1lookup.dev
Request
phone_number
Price
3 credits
Coverage
Global
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Pick the right SMS route

Messaging rates and delivery paths depend on the destination network. Look up the carrier first and send each message down the route built for that operator.

Use porting as a risk signal

A ported number is common and usually harmless. Combined with other signals, such as a new device or a changed email, it can justify a step-up check before a payout or password reset.

Forecast termination costs

Voice and SMS pricing differs by network. Tag a destination list with carriers before a campaign and you can estimate spend per operator instead of per country.

Keep carrier fields in your CRM current

Bulk-check stored numbers on a schedule and overwrite stale carrier values. Reports that segment by network stay correct as customers switch providers.

Carrier Lookup reports who serves a number, not whether the handset is switched on. Use HLR Lookup when you need live status.

[06/Cost]

3 credits

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83$14.50
Growth $99/mo$3.96$11.88
Pro $299/mo$3.32$9.97
Scale $799/mo$2.66$7.99
[07/FAQ]

Carrier Lookup questions

What is the difference between a carrier lookup and an HLR lookup?

Carrier Lookup reads number portability data to tell you who serves a number. HLR Lookup queries the mobile network itself and adds live status and roaming. Carrier Lookup costs less and is enough when you do not need to know if the phone is on.

What do MCC and MNC mean?

MCC is the mobile country code and MNC is the mobile network code. Together they identify a single mobile network, and most messaging platforms use the pair as a routing key.

What is the price per lookup?

Three credits per number. The result is cached for 7 days, so asking about the same number again in that period does not use credits.

Which countries does it cover?

Coverage is global. In countries that do not offer number portability, the current carrier is simply the original range holder and ported is always false.

Can I look up landlines?

The product is built for mobile numbers. For fixed lines and VoIP numbers in the US and Canada, Phone Validation returns carrier and line type for 1 credit.

[ Validate ][ Enrich ]
[Get started]

Run Carrier Lookup on your own data

Starter is $29 a month for 6,000 credits, enough for 2,000 lookups a month.

[ Screen ][ Scrape ]