---
title: "Search available phone numbers"
method: POST
path: "/internal/telephony/phone-numbers/search"
tags: ["Telephony - Phone Numbers"]
---

# Search available phone numbers

`POST /internal/telephony/phone-numbers/search`

Search for available phone numbers to purchase.

## Request body

- SearchPhoneNumbers
  - `countryCode` string — ISO country code
  - `areaCode` string — Area code
  - `contains` string — Number pattern
  - `numberType` 'local' | 'toll_free' | 'mobile' | 'national' — Number type
  - `limit` number — Max results

## Response `200`

Available numbers

- object
  - `numbers` AvailablePhoneNumber[], required
    - `phoneNumber` string, required — Phone number
    - `nationalFormat` string, nullable, required — National format
    - `phoneNumberType` string, required — Type
    - `regionInformation` unknown
    - `cost` unknown
    - `features` unknown
  - `total` number, required

## Other responses

- `400` — Validation error
- `401` — Unauthorized

---

[API](https://skmtc.net/nedzo/apis/nedzo-api.md) · [All operations](https://skmtc.net/nedzo/apis/nedzo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nedzo/nedzo-api/versions/f2607cdb56fa/schema)