Skip to main content
POST
/
api
/
public
/
v1
/
telephony
/
numbers
/
search
Search Numbers
curl --request POST \
  --url https://api.truedy.ai/api/public/v1/telephony/numbers/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "country_code": "US",
  "locality": "<string>",
  "area_code": "<string>",
  "administrative_area": "<string>",
  "phone_number_type": "<string>",
  "api_key": "<string>",
  "page": 1,
  "page_size": 20
}
'
{
  "data": {},
  "meta": {
    "request_id": "req_73e786fe-1",
    "timestamp": "2026-02-04T20:12:04.403365Z"
  }
}

Authorizations

Authorization
string
header
required

Your API key. Send in the Authorization header as: Bearer

Body

application/json
country_code
string
default:US

ISO country code

locality
string | null

City/region to search in

area_code
string | null

Area code (NDC) to filter by (e.g. 212)

administrative_area
string | null

State or province to filter by

phone_number_type
string | null

Telnyx filter: local, toll_free, mobile, national, shared_cost

api_key
string | null

Optional Telnyx API key (uses master if not provided)

page
integer | null
default:1

Page number (1-based) for pagination

Required range: x >= 1
page_size
integer | null
default:20

Number of results per page

Required range: 1 <= x <= 100

Response

Resource created successfully