---
title: "Deletes a reservation by its ID."
method: DELETE
path: "/availablePhoneNumbers/reservations/{reservationId}"
tags: ["Browse, reserve and purchase available phone numbers"]
---

# Deletes a reservation by its ID.

`DELETE /availablePhoneNumbers/reservations/{reservationId}`

Deletes the reservation with the given ID. Any phone number in the reservation will be released and made available for others to purchase. Only reservations with 'active' status can be deleted.

## Path parameters

- `reservationId` string, uuid, required

## Query parameters

- `api-version` string, required

## Response `204`

Reservation successfully deleted.

## Other responses

- `default` — Failure

## Changes

- **2021-05-19** (2021-03-07) `5c6abf2b2252` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/communication-phonenumbers/changes/availablePhoneNumbers/reservations/:reservationId/delete.md)

---

[API](https://skmtc.dev/azure/apis/communication-phonenumbers.md) · [All operations](https://skmtc.dev/azure/apis/communication-phonenumbers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-phonenumbers/revisions/6e81b3741aa7/schema)