---
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
- `numberType` 'local' | 'mobile' | 'national' | 'toll_free'
- `areaCode` 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 offerable, numberType outside the four offered, or a query parameter this endpoint does not know (the message lists the accepted ones; nothing is silently ignored).
- `401` — Unauthorized

## Changes

- **2026-09-23** `dd3865482f9f` — 4 info
  - added the new optional `query` request parameter `areaCode`
  - added the new optional `query` request parameter `numberType`
  - `query` request parameter `prefix` was deprecated
  - `query` request parameter `type` was deprecated
- **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/dd3865482f9f?raw)