---
title: "List virtual numbers available to buy"
method: GET
path: "/get-available-numbers/"
tags: ["Numbers"]
---

# List virtual numbers available to buy

`GET /get-available-numbers/`

## Request

- Base URL: `http://api.smsfusion.com.au`
- URL: `http://api.smsfusion.com.au/get-available-numbers/`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP basic

Dedicated virtual numbers currently available for purchase from the platform pool, with per-month and per-year pricing

## Query parameters

- `key` string, required
- `country` string

## Response `200`

Successfull response

- object[]
  - `number` string
  - `country` string
  - `sms` boolean
  - `mms` boolean
  - `voice` boolean
  - `pricemonth` string: Decimal string, e.g. 9.95
  - `priceyear` string: Decimal string, e.g. 99.50

## Other responses

- `401`: Authentication failed or paramaters not provided

---

[API](https://skmtc.dev/smsfusion/apis/sms-fusion-api.md) · [All operations](https://skmtc.dev/smsfusion/apis/sms-fusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smsfusion/apis/sms-fusion-api/revisions/a88b2793a6e9?raw)