---
title: "DELETE /api/numbers/{number}"
method: DELETE
path: "/api/numbers/{number}"
---

# DELETE /api/numbers/{number}

`DELETE /api/numbers/{number}`

## Request

- Base URL: `https://call4.me`
- URL: `https://call4.me/api/numbers/{number}`
- Auth: HTTP bearer

Give up one of the account's bought numbers. Its monthly charge stops; what was already paid is not refunded, and the number cannot be gotten back. The free number that came with the account cannot be released. Only do this when the user asks.

## Path parameters

- `number` string, required: one of the account's numbers, e.g. "+31612345678"

## Response `200`

The number released

- object
  - `number` string, required: formatted for people
  - `e164` string, required
  - `country` string, required: ISO 3166-1 alpha-2
  - `country_name` string, required
  - `type` string, required: local, mobile, national or toll_free
  - `included` boolean, required: the free number that came with the account
  - `monthly` string, required
  - `monthly_cents` integer, required
  - `renews` string, nullable, required: date the next monthly charge is due; null for the free number
  - `overdue` boolean, required: the last renewal failed for lack of credits
  - `release_after` string, nullable, required: when an overdue number is released unless credits are added

## Other responses

- `401`: Request failed
- `404`: Request failed
- `409`: Request failed
- `502`: Request failed

---

[API](https://skmtc.dev/call4/apis/call4me-api.md) · [All operations](https://skmtc.dev/call4/apis/call4me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call4/apis/call4me-api/revisions/f4fa1a5c5f9b?raw)