Phone number intelligence, carrier lookup, and North American numbering data
The Telco API provides comprehensive access to North American telephone numbering data, including phone number lookups, carrier information, area code (NPA) and exchange (NXX) data, and phone number formatting.
https://api.do.dev/v1/telcoAll Telco endpoints require the telco:read scope.
telco:read| Method | Path | Description |
|---|---|---|
| GET | /v1/telco/lookup/{tn} | Look up a phone number |
| GET | /v1/telco/npa/{npa} | Get exchanges for an area code |
| GET | /v1/telco/npa/{npa}/nxx/{nxx} | Get NPA-NXX details |
| GET | /v1/telco/search | Search NPA-NXX or inventory |
| GET | /v1/telco/carrier/{ocn} | Get carrier by OCN |
| GET | /v1/telco/carriers | List or search carriers |
| GET | /v1/telco/format/{tn} | Format and validate a number |
| GET | /v1/telco/stats | Database statistics |
The Telco API generates events that can be delivered to your webhook endpoints:
| Event Type | Trigger |
|---|---|
telco.lookup.completed | Phone number lookup completed |
telco.search.completed | Number search query completed |
See Telco Webhooks for payload details, or Webhooks & Events for the full system overview.