---
title: "Search Available Telnyx Numbers"
method: POST
path: "/api/channels/telnyx/numbers/search"
tags: ["channels", "channels", "telnyx-voice"]
---

# Search Available Telnyx Numbers

`POST /api/channels/telnyx/numbers/search`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/channels/telnyx/numbers/search`
- Auth: none declared

List purchasable Telnyx numbers for a country.

Note for callers: a Trial-level Telnyx account returns numbers with the
digits REDACTED (e.g. `+17406------`) for every country except its own
country of origin, and ordering a redacted number fails with code
10027. Surface Telnyx's message rather than flattening it.

## Request body

- TelnyxNumberSearchRequest
  - `api_key` string, required: Telnyx API v2 key
  - `country_code` string: ISO-3166-1 alpha-2, e.g. TH
  - `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)