---
title: "Release a phone number"
method: DELETE
path: "/phone_numbers/{id}"
tags: ["Phone numbers"]
---

# Release a phone number

`DELETE /phone_numbers/{id}`

Releases a phone number from the account.

## Path parameters

- `id` string, required — The ID of the phone number to release.

## Response `200`

Released phone number

- PhoneNumber — A phone number that can be used to send and receive messages and calls
  - `campaign_id` string, nullable, required — The unique identifier of the campaign this phone number is attached to, if any
  - `id` string, required — Unique identifier for the phone number
  - `name` string, nullable, required — A human-readable name for the phone number
  - `number` string, phone-number, required — The phone number in E.164 format
  - `type` 'local' | 'short_code' | 'toll_free', required — Whether the phone number is local, toll-free, or short code

## Other responses

- `default` — Error

## Changes

- **2026-05-27** `4c24c03044b4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/surgeapi/apis/surge/changes/phone_numbers/:id/delete.md)

---

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