---
title: "Release phone numbers"
method: DELETE
path: "/v1/numbers"
tags: ["My numbers"]
---

# Release phone numbers

`DELETE /v1/numbers`

Releases the listed phone numbers back to stock. Selection accepts either `ids` (record IDs) or `dids` (phone numbers), but not both.

## Query parameters

- `ids` integer[]
- `dids` string

## Response `200`

Returns a success confirmation. The numbers are released back to stock.

- object
  - `success` boolean, required — Indicates whether the request was successful.

## Other responses

- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.
- `422` — Validation error

## Changes

- **2026-06-15** `76b9bb35619f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wavix/apis/wavix-apis/changes/v1/numbers/delete.md)

---

[API](https://skmtc.dev/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.dev/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)