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

# Release a phone number

`DELETE /v1/phone-numbers/{id}`

## Request

- Base URL: `https://api.mailfixture.com`
- URL: `https://api.mailfixture.com/v1/phone-numbers/{id}`
- Auth: HTTP bearer

Releases the number at the provider first, then deletes it and all of its texts immediately. A provider failure leaves the number owned so the call can be retried.

## Path parameters

- `id` string, uuid, required

## Response `204`

Number released; its texts are gone.

## Other responses

- `401`: Missing bearer token, malformed key, or unknown/revoked/invalid API key.
- `404`: No such phone number on this account.
- `409`: The number order is still pending — wait for it to become active before releasing.
- `429`: Per-key rate limit exceeded. `Retry-After` says when the next request will be admitted; the RateLimit headers name the bucket that refused (`requests` or `creates`) with `r=0`.
- `500`: Unexpected server error. `detail` is null — internals are never leaked.
- `503`: Release failed at the provider; try again shortly.

---

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