Lookup

Look up detailed information about a phone number

GET/v1/telco/lookup/{tn}

Returns carrier, location, and inventory data for a phone number.

Requires:telco:read

Path Parameters

tnstringrequired

Phone number to look up. Accepts various formats: 2125551234, (212) 555-1234, +1-212-555-1234

Query Parameters

tnstring

Alternative: pass the phone number as a query parameter instead of in the path

Look up a phone number

curl "https://api.do.dev/v1/telco/lookup/2125551234" \
-H "Authorization: Bearer YOUR_API_KEY"

Response200

{
"tn": "2125551234",
"npa": "212",
"nxx": "555",
"nxxx": "1234",
"carrier": {
  "ocn": "VZXX",
  "name": "Verizon Communications",
  "type": "ILEC"
},
"location": {
  "rateCenter": "NEW YORK",
  "state": "NY",
  "country": "US"
},
"inventory": {
  "division": "...",
  "provider": "...",
  "active": true,
  "smsEnabled": true,
  "lidbEnabled": false
}
}

Error Responses

{
"error": "bad_request",
"message": "Invalid phone number format"
}