---
title: "Release an SMS number"
method: DELETE
path: "/v1/sms-numbers/{e164}"
---

# Release an SMS number

`DELETE /v1/sms-numbers/{e164}`

## Request

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

Releases an SMS number: it goes back to the carrier and cannot be recovered, and messages sent to it afterwards no longer reach you. Messages already received stay listed until their 90 days are over. The fee for the running 30-day period is not refunded. If releasing fails at the carrier, the number stays in `status: "releasing"`; send the same request again to release it.

## Path parameters

- `e164` string, required

## Response `200`

Released

- object
  - `released` true, required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: not_found (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `502`: Error codes: release_failed (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)