---
title: "Search available numbers"
method: GET
path: "/v1/phone-numbers/available"
tags: ["Phone Numbers"]
---

# Search available numbers

`GET /v1/phone-numbers/available`

Search the provider's inventory for numbers available to purchase in a
country (default US). Optional filters narrow the results. The country
must be offerable (see GET /v1/phone-numbers/countries). Voice
capability is always required; pass `sms=true` to only see numbers that
can also text (SMS support is per-number, not per-country).

## Query parameters

- `country` string
- `type` string
- `prefix` string
- `locality` string
- `contains` string
- `sms` boolean
- `limit` integer

## Response `200`

Available numbers.

- object
  - `country` string
  - `numberType` string
  - `requireSms` boolean — Echo of the `sms` filter applied to this search.
  - `numbers` object[]
    - `phoneNumber` string
    - `features` string[] — Provider capability list for this number (e.g. voice, sms, mms).

## Other responses

- `400` — Country not available
- `401` — Unauthorized

---

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