Search

Search NPA-NXX records or phone number inventory with filters

GET/v1/telco/search

Search NPA-NXX or inventory records with flexible filters. At least one filter is required.

Requires:telco:read

Query Parameters

sourcestring

Data source to searchDefaults to npanxx

npanxxinventory

npastring

Filter by area code

nxxstring

Filter by exchange code

statestring

Filter by state abbreviation (e.g., NY, CA)

rateCenterstring

Filter by rate center name (partial match)

ocnstring

Filter by carrier OCN

divisionstring

Filter by division (inventory source only)

providerstring

Filter by provider name (inventory source only, partial match)

activeboolean

Filter by active status (inventory source only)

smsEnabledboolean

Filter by SMS capability (inventory source only)

pageinteger

Page number for paginationDefaults to 1

pageSizeinteger

Results per page (max 100)Defaults to 50

At least one filter parameter is required: npa, state, rateCenter, ocn, division, or provider.

Search by state

curl "https://api.do.dev/v1/telco/search?state=NY&pageSize=10" \
-H "Authorization: Bearer YOUR_API_KEY"

Response200

{
"results": [
  {
    "tn": "212555XXXX",
    "npa": "212",
    "nxx": "555",
    "rateCenter": "NEW YORK",
    "state": "NY",
    "carrier": "Verizon Communications"
  }
],
"total": 142,
"page": 1,
"pageSize": 10
}