Reverse phone lookup API
Reverse Phone Lookup API
Turn a bare phone number into facts you can act on: where it is from, which operator it belongs to, whether it is a mobile, landline or VoIP line and which time zone it is in. numlookupapi does not return the name or address of the person behind a number.
Example request and response
The lookup 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",
"country_name": "United States of America",
"location": "Novato",
"carrier": "AT&T Mobility LLC",
"line_type": "mobile",
"timezones": ["America/Los_Angeles"],
…
}
Response fields
- country_code, country_name
- The country the number belongs to.
- location
- Region or city associated with the number. May be empty.
- carrier
- The operator the number range was assigned to. May be empty.
- line_type, number_type
- Mobile, landline, toll-free, premium rate, VoIP and other line types.
- timezones
- The IANA time zones of the number's area.
Use cases
Inbound call and lead screening
See where a caller or lead is from and what kind of line they use before you call back.
Contact center routing
Route calls and callbacks by country and time zone, and call people in their business hours.
Fraud signals
Compare the number's country with the user's IP or billing country, and flag VoIP or premium-rate numbers.
Start on the free plan
The free plan includes 100 requests a month. Paid plans start at $9.99 a month for 5,000 requests without a rate limit.