---
title: "Scan UTXO Set"
method: POST
path: "/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/utxos/scan"
tags: ["Derivations"]
---

# Scan UTXO Set

`POST /v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/utxos/scan`

## 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}/utxos/scan`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/btcpayserver/apis/nbxplorer-api/docs/v1/cryptos/:cryptoCode/derivations/:derivationScheme/utxos/scan/post.ts> (a function with typed inputs; its response is checked against the schema)

Scan the UTXO Set for outputs belonging to the derivation scheme. 
The scan is split into batches to conserve RAM, scanning the whole UTXO set sequentially.
Three branches are scanned: 0/x, 1/x and x.
If a UTXO in one branch is found at a specific x, all addresses inferior to index x will be considered used.

## Path parameters

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

## Query parameters

- `batchSize` integer
- `gapLimit` integer
- `from` integer

## Response `200`

Scan request queued

## Other responses

- `400`: RPC unavailable. Code: `rpc-unavailable`
- `405`: ScanUTXOSet not supported. Code: `scanutxoset-not-suported`
- `409`: ScanUTXOSet already in progress. Code: `scanutxoset-in-progress`

## Changes

- **2026-09-29** `52231f42c765`: 7 info
  - api operation id `ScanDerivationUTXOSet` was added
  - the response property `httpCode` became required for the status `400`
  - the response property `httpCode` became required for the status `405`
  - the response property `httpCode` became required for the status `409`
  - …3 more
- **2024-11-25** `cfaf4efd4ea8`: 3 breaking, 15 info
  - the response's body type changed from `string` to `object` for status `400`
  - the response's body type changed from `string` to `object` for status `405`
  - the response's body type changed from `string` to `object` for status `409`
  - response schema `application/json` enum value removed `rpc-unavailable`
  - …14 more
- **2024-11-25** `32a04b45196c`: 1 info
  - api tag `Derivations` added
- **2024-11-25** `72a2dfa26976`: 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/utxos/scan/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)