---
title: "Search available phone numbers"
method: GET
path: "/v1/phone-numbers/available"
---

# Search available phone numbers

`GET /v1/phone-numbers/available`

Search for available phone numbers to purchase by country and type.

## Query parameters

- `countryCode` string, required
- `type` 'local' | 'national' | 'tollFree'
- `contains` string
- `capabilities` string
- `limit` integer

## Response `200`

List of available phone numbers.

- object
  - `items` AvailablePhoneNumber[], required
    - `phoneNumber` string, required
    - `friendlyName` string
    - `locality` string
    - `region` string
    - `capabilities` PhoneNumberCapabilities, required
      - `sms` boolean
      - `voice` boolean
      - `mms` boolean
    - `pricing` PhoneNumberPricing, required
      - `monthlyPrice` number — Monthly price in USD.
      - `upfrontPrice` number — One-time purchase price in USD.
      - `isFreeEligible` boolean — Whether this number qualifies as the plan-included US number on paid plans. The benefit is one per account: it is never offered again once claimed, not even after the number is released.

## Other responses

- `400` — Invalid query parameters.
- `401` — Unauthorized.

---

[API](https://skmtc.net/zavudev/apis/zavu-unified-messaging-layer-api.md) · [All operations](https://skmtc.net/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zavudev/zavu-unified-messaging-layer-api/revisions/4dacdff2adf8/schema)