telco.dev API Documentation

Free, open-source phone number lookup API for US and Canadian telephone numbers

Welcome to the telco.dev API documentation. Our API provides carrier information, location data, and number type for any North American phone number.

Features

  • Phone Number Lookup - Get carrier, location, and line type for any 10-digit number
  • Area Code Data - Browse all exchanges (NXX) within an area code
  • Carrier Search - Find carriers by name, OCN, state, or country
  • Free Tier - 100 lookups/day at no cost
  • Daily Updates - Data refreshed daily from official sources (NANPA, CNAC)
  • Fast & Reliable - Built on our global edge network

Quick Example

curl -H "X-API-Key: your-api-key" \
  "https://api.telco.dev/v1/lookup/4155551234"
{
  "tn": "4155551234",
  "npa": "415",
  "nxx": "555",
  "line": "1234",
  "carrier": {
    "ocn": "9740",
    "name": "PACIFIC BELL",
    "type": "LANDLINE"
  },
  "location": {
    "rate_center": "SAN FRANCISCO",
    "state": "CA",
    "country": "US"
  },
  "status": "ASSIGNED",
  "source": "NANPA",
  "last_updated": "2025-01-15T00:00:00Z"
}

Base URL

All API requests should be made to:

https://api.telco.dev/v1

Next Steps