---
title: "List the SMS numbers owned by the account"
method: GET
path: "/v1/sms-numbers"
---

# List the SMS numbers owned by the account

`GET /v1/sms-numbers`

## Request

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

The SMS numbers on the account (the SMS number add-on): Czech mobile numbers that receive SMS and send them from your own number. Each carries `status` (`active`, or `releasing` while a release is running or waiting for a retry), the fee `monthlyFeeHal` per 30-day period and `nextChargeAt`, when the next one is due. The send limit is in `dailySendLimit` (20 SMS per 24-hour window during the number's first 30 days, then 50), `dailySendRemaining` (how many are left, 0 for a number being released) and `dailySendResetsAt` (when the window ends, `null` when none is running); the window is shared by all SMS numbers of the account, starts with the first SMS sent and also counts attempts over the limit and SMS the carrier rejected. Listing works even when new purchases are unavailable.

## Response `200`

SMS numbers

- object
  - `smsNumbers` object[], required
    - `number` string, required: The SMS number in E.164 format, for example +420777123456.
    - `status` 'active' | 'releasing', required: active: the number receives and sends. releasing: the release is in progress or failed and waits for a retry; send DELETE again to finish it.
    - `createdAt` number, required: When the number was bought, as a Unix epoch timestamp in milliseconds.
    - `monthlyFeeHal` number, required: Fee per 30-day period in hellers (1/100 CZK), excluding VAT, charged from the credit balance.
    - `nextChargeAt` number, required: When the next 30-day fee is due, as a Unix epoch timestamp in milliseconds.
    - `dailySendLimit` number, required: How many SMS your account may send from this number in a 24-hour window that starts with the first SMS sent from any SMS number of the account: 20 during the number's first 30 days, 50 afterwards.
    - `dailySendRemaining` number, required: How many more SMS can be sent from this number in the current window. The window is shared by all SMS numbers of the account and also counts attempts over the limit and SMS the carrier rejected. 0 for a number that is being released; sending also requires SMS numbers to be enabled for the account.
    - `dailySendResetsAt` number, nullable, required: When the current 24-hour window ends and the count starts again, as a Unix epoch timestamp in milliseconds. null when no window is running; the next SMS sent from an SMS number starts one.

## Other responses

- `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)