---
title: "Delete telephone number on an account"
method: DELETE
path: "/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}"
tags: ["Telephone Number"]
---

# Delete telephone number on an account

`DELETE /v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/partition/:partitionId/account/:accountId/telephonenumber/:tn/delete.ts> (a function with typed inputs; its response is checked against the schema)

Use to delete a telephone number on an account.<br/><br/> This is not possible if the telephone number has any outstanding activation events.<br/><br/> The phone number is placed in "cooldown" for the number of days specified in <a href="#/~schema/PartitionX">partition.tnDeleteCooldownDays</a>, after which it is returned the inbound carrier unless reclaimed to inventory first.  Cooldown is intended to give the customer time to regret their decision and get their number back.<span hidden><br/><br/> See <a href="tnAccount.html#deleteTelephoneNumberOnAccount">here</a> for more information.</span>

## Path parameters

- `accountId` string, required
- `partitionId` string, required
- `tn` string, required

## Response `204`

Telephone account successfully deleted

## Other responses

- `400`: Cannot delete now due to unterminated serviceActivationEvent, or port in progress<br/><br/> Data array will explain the specific reason(s) why the telephone number cannot be deleted.
- `401`: Unauthorized
- `404`: Telephone account not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/cb514a0728ed?raw)