GET /carrier/{number}
Carrier lookup API
Pass a phone number. The network says who serves it.
Example response
GET /carrier/+12127365000?deep=true
{
"phone": "+12127365000",
"valid": true,
"country": "US",
"type": "voip",
"carrier": "Sinch Voice",
"burner": false,
}100 free lookups a month. Additional lookups are priced by your plan.
Coverage
Worldwide carrier lookups. Results are cached between network checks.
Ask the network who serves a number. Get the carrier, real line type including VoIP, and a flag for known burner apps. Add deep=true for the city and state where the number block was issued.
Core and detail use the same single carrier lookup. Free includes 100 a month. Invalid numbers use no carrier unit; see Plans for additional lookup rates.
Make your first request.
One key works across the APIs. Copy a request in your language and get JSON back.
curl "https://api.parseapi.com/carrier/+12127365000" \
-H "X-API-Key: YOUR_API_KEY"// Example response · 200{"phone": "+12127365000", "valid": true, "country": "US", "type": "voip", "carrier": "Sinch Voice", "burner": false }
?deep=true Recorded issuing location, included in the same carrier lookup. Included in the same lookup, with no additional charge.
API referenceSDKsKeys and authentication
Every response field
Response fields
Deep fields
- deep.city
- City where the number block was issued (not live location). Gazetteer name when known, readable expansion otherwise
- deep.state
- State/province code from the area code (NANP), else null
- deep.state_name
- State/province name from the area code (NANP), else null
SPEED
How long /carrier takes.
Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.
US
106ms
EU
296ms
APAC
408ms
LatAm
387ms
ME
469ms
QUESTIONS
- Where does the data come from?
- Carrier and line type come from network lookups. Results are cached between checks.
- What can it see that a parser cannot?
- voip. A voip number sits inside a regular-looking block, so offline parsing calls it landline or mobile. The network names the real service.
- What is the burner flag?
- true when the carrier itself names a known burner app, TextNow or Pinger class. A curated list, never a score. null when the carrier is unknown.
- Is the city where the phone is now?
- deep.city is where the number block was issued. Request deep=true for city and state in the same carrier lookup, with no additional charge.
- What does a lookup cost?
- One carrier lookup from the monthly allowance per valid number. Free includes 100 a month. See Plans for additional lookup rates. Junk numbers answer valid: false free.
- Can I get the caller ID?
- GET /caller returns the name a phone screen shows. North American numbers.
- Can I check assignment and reachability?
- GET /hlr returns assignment and reachability at the last network check. Results are cached.
- Just need validation?
- GET /phone validates and formats any number. 245 countries and regions.
- Can I run a list?
- Drop a phone CSV on /bulk. Your quote shows the price for unique numbers. A number that fails validation never pays for the network checks.
Phone APIs
Phone
Valid, formatted, plus the line type. Optional numbering-plan detail.
Carrier
Who serves it. Real line type, including voip. Burner flag.
Caller ID
The name a phone screen shows.
Live status
Assignment and reachability at the last network check.
Have a list?
Drop a phone CSV. Carrier is a toggle on the quote. See your exact price before paying.
Drop a CSV, Excel, or Numbers file
or choose a file
Know the network.
Carrier and line type in one lookup. Checks have their own allowance.
Start includes 1M API requests a month for $20/mo.
1,000 carrier lookups included per month.