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

• Quick Start - Get your API key and make your first request
• Authentication - Learn how to authenticate requests
• API Reference - Explore all available endpoints