Carrier lookup API
Carrier and Line Type Lookup API
Look up which operator a phone number belongs to and what kind of line it is: mobile, landline, toll-free, premium rate, VoIP and more. One call returns the carrier and line type together with the number's country, location and formats.
Example request and response
The carrier and line type fields of the /v1/validate example response (shortened).
curl "https://api.numlookupapi.com/v1/validate/+14158586273" \
-H "apikey: YOUR-API-KEY"
{
"valid": true,
"country_code": "US",
"location": "Novato",
"carrier": "AT&T Mobility LLC",
"line_type": "mobile",
"number_type": "landline_or_mobile",
"e164_format": "+14158586273",
…
}
Response fields
- carrier
- The operator the number range was assigned to. May be empty.
- line_type
- landline, mobile, satellite, paging, special_services, premium_rate, toll_free or N/A.
- number_type
- Finer type from the international numbering data: landline, mobile, landline_or_mobile (US and Canada), toll_free, premium_rate, shared_cost, voip, personal_number, pager, uan, voicemail or unknown.
- location, country_code
- Region or city and country of the number.
Use cases
SMS routing
Send SMS only to mobile numbers, and route by operator where your provider prices differ.
Fraud screening
Flag VoIP and premium-rate numbers at sign-up, where they are often used to create throwaway accounts.
CRM enrichment
Add carrier and line type to your contacts so sales and support know how to reach them.
Start on the free plan
The free plan includes 100 requests a month with carrier and line type. Paid plans start at $9.99 a month for 5,000 requests without a rate limit.