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

# Search available numbers

`GET /v1/whatsapp/phone-numbers/available`

> **Deprecated.**

Deprecated alias of `/v1/phone-numbers/available`; same contract. New
integrations should use that path.

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/whatsapp/phone-numbers/countries).

## Query parameters

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

## Response `200`

Available numbers.

- object
  - `country` string
  - `numberType` string
  - `numbers` object[]
    - `phoneNumber` string
    - `locality` string
    - `bestEffort` boolean

## Other responses

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

## Changes

- **2026-09-10** `e70ed06e7150` — 2 info
  - added the optional property `numbers/items/bestEffort` to the response with the `200` status
  - added the optional property `numbers/items/locality` to the response with the `200` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/whatsapp/phone-numbers/available/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/eded32b62823?raw)