---
title: "List the exact numbers currently loaded for purchase. Each row is an availability snapshot, not a reservation: availability and price are rechecked with the carrier before the number is ordered, so a row past its expires_at can still be chosen"
method: GET
path: "/v1/available-numbers"
---

# List the exact numbers currently loaded for purchase. Each row is an availability snapshot, not a reservation: availability and price are rechecked with the carrier before the number is ordered, so a row past its expires_at can still be chosen

`GET /v1/available-numbers`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/available-numbers`
- Auth: none declared

## Query parameters

- `country` string
- `number_type` string
- `area_code` string
- `region` string
- `limit` integer

## Response `200`

rows (id, country, number_type, phone_number, capabilities, customer prices, area_code, area_name, city, region, region_code, checked_at, expires_at), inventory_mode (exact_cached|category_fallback) and has_more

## Other responses

- `400`: area_code is not 1-6 digits, region is longer than 64 characters, or limit is not an integer

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)