---
title: "Get UTXOs for a group"
method: GET
path: "/v1/cryptos/{cryptoCode}/groups/{groupId}/utxos"
tags: ["Groups"]
---

# Get UTXOs for a group

`GET /v1/cryptos/{cryptoCode}/groups/{groupId}/utxos`

Retrieves the list of unspent transaction outputs (UTXOs) associated with the specified group.

## Path parameters

- `cryptoCode` string, required
- `groupId` string, required

## Response `200`

UTXOs retrieved successfully.

- UTXOChanges
  - `trackedSource` string — The tracked source identifier, which can be a group or a derivation scheme.
  - `currentHeight` integer — The current height of the blockchain.
  - `unconfirmed` UTXOChange — The list of unconfirmed UTXOs and of spent confirmed UTXOs
    - `utxOs` UTXO[]
      - `feature` string — Specifies the type of address from which this UTXO originated. Possible values are: - `Deposit`: An address from the external chain (`0/x`). - `Change`: An address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
      - `outpoint` string — The unique identifier of the UTXO, consisting of the transaction ID and the output index, formatted as `{transactionHash}-{outputIndex}`.
      - `index` integer — The index of the output in the transaction. Indicates which output of the transaction this UTXO corresponds to.
      - `transactionHash` string — The transaction ID (hash) of the transaction that created this UTXO.
      - `scriptPubKey` string — The scriptPubKey of the UTXO in hexadecimal format. This script specifies the conditions under which the UTXO can be spent.
      - `address` string — The Bitcoin address corresponding to the scriptPubKey.
      - `value` integer — The amount of the UTXO in satoshis.
      - `keyPath` string — The derivation path used to derive the address for this UTXO from the master public key. For example, `0/0`. (Only for standard derivation schemes)
      - `keyIndex` string — This index of this key in the `feature`.
      - `timestamp` integer — The UNIX timestamp indicating when the UTXO was first seen by NBXplorer.
      - `confirmations` integer — The number of confirmations of the transaction containing this UTXO. A value of `0` means the transaction is unconfirmed.
    - `spentOutpoints` string[] — List of confirmed outpoints that were spent. (Only available for the unconfirmed UTXOChange)
  - `confirmed` UTXOChange — The list of unconfirmed UTXOs and of spent confirmed UTXOs
    - `utxOs` UTXO[]
      - `feature` string — Specifies the type of address from which this UTXO originated. Possible values are: - `Deposit`: An address from the external chain (`0/x`). - `Change`: An address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
      - `outpoint` string — The unique identifier of the UTXO, consisting of the transaction ID and the output index, formatted as `{transactionHash}-{outputIndex}`.
      - `index` integer — The index of the output in the transaction. Indicates which output of the transaction this UTXO corresponds to.
      - `transactionHash` string — The transaction ID (hash) of the transaction that created this UTXO.
      - `scriptPubKey` string — The scriptPubKey of the UTXO in hexadecimal format. This script specifies the conditions under which the UTXO can be spent.
      - `address` string — The Bitcoin address corresponding to the scriptPubKey.
      - `value` integer — The amount of the UTXO in satoshis.
      - `keyPath` string — The derivation path used to derive the address for this UTXO from the master public key. For example, `0/0`. (Only for standard derivation schemes)
      - `keyIndex` string — This index of this key in the `feature`.
      - `timestamp` integer — The UNIX timestamp indicating when the UTXO was first seen by NBXplorer.
      - `confirmations` integer — The number of confirmations of the transaction containing this UTXO. A value of `0` means the transaction is unconfirmed.
    - `spentOutpoints` string[] — List of confirmed outpoints that were spent. (Only available for the unconfirmed UTXOChange)
  - `spentUnconfirmed` string[] — List of still unconfirmed outpoints that were spent. For a transaction chain `A->B->C` where `B` spends `A` and `C` spends `B`, outpoints `A` and `B` will appear here since they remain unconfirmed until the entire chain confirms.

---

[API](https://skmtc.net/btcpayserver/apis/nbxplorer-api.md) · [All operations](https://skmtc.net/btcpayserver/apis/nbxplorer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btcpayserver/nbxplorer-api/revisions/208cac39e31a/schema)