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

# Search Available Phone Numbers

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

## Request

- Base URL: `https://api.fish.audio`
- URL: `https://api.fish.audio/v1/agent/available-phone-numbers`
- Auth: HTTP bearer

Search the purchasable number inventory. Buy an entry with
`POST /v1/agent/phone-numbers`; availability is not a reservation, so a listed
number can still be claimed by someone else first.

## Query parameters

- `country_code` string
- `area_code` string, nullable
- `number_type` 'local' | 'toll_free'
- `provider` 'twilio', nullable

## Response `200`

Request fulfilled, document follows

- object
  - `available_phone_numbers` object[], required: Inventory entries forwarded from the provider (number, region, pricing).

## Other responses

- `400`: Bad request syntax or unsupported method
- `401`: No permission -- see authorization schemes
- `502`: Invalid responses from another server/proxy
- `503`: The server cannot process the request due to a high load

## Changes

- **2026-11-03** `42ac421f7a12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fish/apis/fishaudio-openapi/changes/v1/agent/available-phone-numbers/get.md)

---

[API](https://skmtc.dev/fish/apis/fishaudio-openapi.md) - [All operations](https://skmtc.dev/fish/apis/fishaudio-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fish/apis/fishaudio-openapi/revisions/42ac421f7a12?raw)