---
title: "List available numbers"
method: GET
path: "/v1/numbers"
tags: ["Senders"]
---

# List available numbers

`GET /v1/numbers`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/numbers`
- Auth: API key in header `X-Dexatel-Key`

## Query parameters

- `type` 'Local' | 'Toll-free', required
- `country` string, required

## Response `200`

OK

- NumberResponseListWrapperDto
  - `data` NumberResponseDto[]
    - `number` string: Phone number available for purchase
    - `type` string: Phone number type
    - `country` string: ISO country code
    - `setup_cost` number, double: Setup cost of the number
    - `monthly_cost` number, double: Monthly cost of the number

## Other responses

- `400`: **Bad Request:** Code Message Description 1411 Invalid number type specified Should be one of \[Local, Toll-free\] 1412 Invalid country iso code
- `404`: **Not Found:** Code Message 1413 The configuration for the specified parameters not found

---

[API](https://skmtc.dev/dexatel/apis/contacts-and-messaging.md) - [All operations](https://skmtc.dev/dexatel/apis/contacts-and-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/contacts-and-messaging/revisions/f07e4f03a129?raw)