---
title: "Find dedicated numbers available for purchase"
method: GET
path: "/api/v2/numbers/available"
tags: ["Numbers"]
---

# Find dedicated numbers available for purchase

`GET /api/v2/numbers/available`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/undefined/getAvailableDedicatedNumbers" target="_blank">Try in sandbox</a><br>

## Query parameters

- `prefix` integer
- `tollfree` 0 | 1
- `country` string, required

## Response `200`

The list of available to buy dedicated numbers.

- GetAvailableDedicatedNumbersResponse
  - `numbers` string[], required — Array of phone numbers.
  - `price` number, float, required — Dedicated number monthly fee for this country. Returned in the current [account](https://docs.textmagic.com/#tag/User) currency.
  - `giftType` 'none' | 'registration' | 'first_month' | 'include_in_plan', required

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.
- `404` — Request data not found.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)