---
title: "List numbers currently available to buy"
method: GET
path: "/v1/numbers/available"
---

# List numbers currently available to buy

`GET /v1/numbers/available`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/numbers/available`
- Auth: HTTP bearer

The listing of numbers available to buy (max 5 per region). `numbers` holds the numbers from the selected region (Prague if you skip the parameter), `regions` always returns the whole listing at once - including `bratislava` (a Slovak number with a different fee, see `POST /v1/numbers` above).

## Query parameters

- `region` 'praha' | 'brno' | 'internet' | 'bratislava'

## Response `200`

Available numbers per region

- object
  - `region` string, required
  - `numbers` string[], required
  - `regions` object[], required
    - `id` string, required
    - `label` string, required
    - `description` string, required
    - `numbers` string[], required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

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