Skip to content

Latest commit

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

phone lookup api

✨ Phone Lookup API 📞

Identify the carrier, line type (mobile / landline / VoIP), validity, and formatting for any phone number worldwide. Clean JSON, one fast request per number.

(Programming Language - Python 3)

phone-lookup-api forksRepo stars

View

Phone Lookup API tells you who carries a phone number and what kind of line it is. Send a number in E.164 format and get back clean JSON — whether it's valid, the carrier name, the line type (mobile, landline, or VoIP), the country, and both E.164 and national formatting — in a single fast request.

Use it to validate and clean phone lists, route SMS to mobile numbers only, flag VoIP numbers for fraud checks, and enrich CRM records with carrier and country. Works for numbers worldwide — pass any country's number in E.164 and get consistent, structured data back.

Try the Phone Lookup API in the live playground — free, no signup

Free Plan: 200 requests per month

The same lookup is also available on Apify and RapidAPI:

Run on ApifyRun on RapidAPI

Example: Look Up a Phone Number in One Request

One request to the lookup API:

GET https://carrier-lookup-api.omkar.cloud/lookup?phone=+12128148373
{
"is_valid_number": true,
"line_type": "mobile",
"carrier": "Verizon Wireless",
"phone_number": "+12128148373",
"national_format": "(212) 814-8373",
"country_code": "US",
"calling_country_code": "1",
"mobile_country_code": "310",
"mobile_network_code": "012"
}

The + in a query string must be URL-encoded as %2B, so phone=+12128148373 becomes phone=%2B12128148373.

Run this exact request in the Playground — no signup, no key →

The playground comes prefilled with this request and runs it against the live API in your browser. The JSON it returns is identical to what the API returns.

Start Getting Data in Minutes

Python and Node.js integration examples are available in the playground, so you can start looking up numbers in minutes.

importrequestsresponse=requests.get(
"https://carrier-lookup-api.omkar.cloud/lookup",
params={"phone": "+12128148373"}, # requests encodes the + for youheaders={"API-Key": "YOUR_API_KEY"},
)
print(response.json())
curl -X GET "https://carrier-lookup-api.omkar.cloud/lookup?phone=%2B12128148373" \
-H "API-Key: YOUR_API_KEY"

API Reference

One GET request against https://carrier-lookup-api.omkar.cloud, authenticated with the API-Key header, returning JSON.

Carrier Lookup

Try it live in the Playground →

GET https://carrier-lookup-api.omkar.cloud/lookup?phone=+12128148373

Identify the carrier and line type for any phone number worldwide.

ParameterRequiredDescription
phoneYesThe phone number in E.164 format — a +, the country code, then the number (e.g. +12128148373, +447911123456). URL-encode the + as %2B.

Response fields

FieldDescription
is_valid_numberWhether the number is a valid, dialable number.
line_typemobile, landline, or voip.
carrierThe carrier / network name (e.g. Verizon Wireless).
phone_numberThe number in E.164 format.
national_formatThe number formatted for its country (e.g. (212) 814-8373).
country_codeISO 3166 alpha-2 country code (e.g. US).
calling_country_codeInternational dialing code (e.g. 1).
mobile_country_codeMCC — mobile country code (mobile numbers).
mobile_network_codeMNC — mobile network code (mobile numbers).
Sample Response (click to expand)
{
"is_valid_number": true,
"line_type": "mobile",
"carrier": "Verizon Wireless",
"phone_number": "+12128148373",
"national_format": "(212) 814-8373",
"country_code": "US",
"calling_country_code": "1",
"mobile_country_code": "310",
"mobile_network_code": "012"
}

Pricing

PlanPriceRequests/Month
Free$0200
Starter$1620,000
Grow$48100,000
Scale$148400,000

1 API call = 1 lookup

Free Plan Available — create your API key →. No credit card for the free tier.

FAQs

Can I try the API before signing up?

Yes. The playground runs live requests in your browser — free, no account, no API key. Try it in the Playground →

What does the API tell me about a number?

Whether it's valid, the carrier/network name, the line type (mobile, landline, or VoIP), the country and dialing code, national and E.164 formatting, and — for mobile numbers — the MCC and MNC network codes.

How do I detect mobile vs landline vs VoIP?

The line_type field returns mobile, landline, or voip. Route SMS only to mobile, skip landlines, and flag voip numbers for extra fraud checks.

Does it work for international numbers?

Yes. Pass any country's number in E.164 format (a +, the country code, then the number). The API returns the carrier, country, and formatting for numbers worldwide.

Why is my request failing with a "+" in the number?

In a URL query string, + means a space — you must URL-encode it as %2B (so phone=%2B12128148373). Most HTTP libraries (like Python's requests) encode it for you when you pass the number as a parameter.

How fresh and accurate is the data?

Every request is answered live against up-to-date carrier and numbering data — not a stale local file you have to download and maintain.

More Data-Quality & Lead APIs

  • Email Verification API — the same clean JSON for email: check whether an address is valid, deliverable, disposable, or a role account, and catch typos before you send. Pair it with phone lookup to clean both columns of a lead list.

  • Google Maps Scraper (3,100+ GitHub Stars) — need tens of thousands of leads? Type a niche and a city ("dentists in New York") and get every matching business — name, address, phone, website, emails, rating, and reviews. The free tier alone pulls up to 100K leads a month.

  • Website Email Contact ScraperFree and open source. Point it at any website and get every email, phone number, and social profile on it, each with source pages and an official/unofficial flag.

Support

Built by developers, for developers — when you reach out, you talk to the engineers who built the API, not a support script. Message us anytime and we'll solve your query within 1 working day.

Contact Us on WhatsApp about Phone Lookup API

Email: happy.to.help@omkar.cloud

Email Us about Phone Lookup API

Love It? Star It! ⭐

From one developer to another: If the Phone Lookup API saved you time, please star the repo.

Here's why it matters: most developers judge an API by its stars before trying it. Your star helps the next developer — someone deciding whether the phone data here is real and reliable — try it with confidence.

It takes only 1 second, and means the world to me.