---
title: "Cancel address reservation"
method: POST
path: "/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/addresses/cancelreservation"
tags: ["Derivations"]
---

# Cancel address reservation

`POST /v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/addresses/cancelreservation`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/addresses/cancelreservation`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/btcpayserver/apis/nbxplorer-api/docs/v1/cryptos/:cryptoCode/derivations/:derivationScheme/addresses/cancelreservation/post.ts> (a function with typed inputs; its response is checked against the schema)

Cancel the reservation of this address so [Get a new unused address](#tag/Derivations/operation/GetUnused) will return it again. (if an address has already been used on-chain, the address won't be cancelled)

## Path parameters

- `cryptoCode` string, required
- `derivationScheme` string, required

## Request body

- string[]

## Response `200`

Call succeeded

## Changes

- **2026-09-29** `52231f42c765`: 1 breaking, 1 info
  - request body became required
  - api operation id `CancelAddressReservation` was added
- **2024-12-27** `dca02386fafa`: 1 info
  - endpoint added
- **2024-11-18** `b5092f204599`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/changes/v1/cryptos/:cryptoCode/derivations/:derivationScheme/addresses/cancelreservation/post.md)

---

[API](https://skmtc.dev/btcpayserver/apis/nbxplorer-api.md) - [All operations](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/revisions/52231f42c765?raw)