---
title: "List Available Numbers"
method: GET
path: "/api/v1/phone-numbers/available-numbers/{iso_country}/"
tags: ["PhoneService"]
---

# List Available Numbers

`GET /api/v1/phone-numbers/available-numbers/{iso_country}/`

## Request

- Base URL: `https://api.ravan.ai`
- URL: `https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/`
- Auth: API key in header `X-Api-Key`

## Path parameters

- `iso_country` string, required

## Query parameters

- `page_size` integer
- `region` string

## Response `200`

Successful response

- ListAvailableNumbersResponse
  - `success` boolean
  - `message` string
  - `data` PhoneNumber[]
    - `iso_country` string: ISO country code
    - `phone_number` string: Phone number in E.164 format
    - `price` integer: Monthly cost of the number
    - `per_minute_price_outbound` integer: Per-minute price for outbound calls
    - `per_minute_price_inbound` integer: Per-minute price for inbound calls

---

[API](https://skmtc.dev/ravan/apis/agni-api.md) - [All operations](https://skmtc.dev/ravan/apis/agni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ravan/apis/agni-api/revisions/53e6f393f46e?raw)
