---
title: "Cancel and archive reservation object"
method: POST
path: "/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/actions/cancel"
tags: ["Telephone Number"]
---

# Cancel and archive reservation object

`POST /v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/actions/cancel`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/actions/cancel`
- Auth: API key in header `X-AUTH-TOKEN`

Cancel a dynamic number order.  Only orders in the status "ON_HOLD" or "REJECTED" can be cancelled, and there's nothing you can do to facilitate this for an order which is "IN_PROGRESS".  Only the inbound carrier can decide to hold or reject an IN_PROGRESS order.<span hidden><br/><br/> See <a href="dynamicInventory.html#cancelAndRemoveDynamicInventoryReservation">here</a> for more information.</span>

## Path parameters

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

## Request body

- CancelActionX
  - `referenceId` string
  - `partitionId` string
  - `accountId` string

## Response `204`

Successful operation

## Other responses

- `400`: Invalid dynamic reservation object activation status
- `401`: Unauthorized
- `404`: PartitionId, AccountId, or MacAddress is 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)