---
title: "Finds unconfirmed transactions by ErgoTree hex of one of its output or input boxes (if present in UtxoState)"
method: POST
path: "/transactions/unconfirmed/byErgoTree"
tags: ["transactions"]
---

# Finds unconfirmed transactions by ErgoTree hex of one of its output or input boxes (if present in UtxoState)

`POST /transactions/unconfirmed/byErgoTree`

## Request body

- string

## Response `200`

Ergo transaction

- ErgoTransactionWithInputBoxes — Transaction indexed with extra information
  - `id` string, base16, required — Base16-encoded transaction id bytes
  - `inputs` ErgoBoxWithSpendingProof[], required — Transaction inputs
    - `boxId` string, base16, required — Base16-encoded transaction box id bytes. Should be 32 bytes long
    - `value` integer, required — Amount of Ergo token
    - `ergoTree` string, base16, required — Base16-encoded ergo tree bytes
    - `creationHeight` integer, required — Height the output was created at
    - `assets` Asset[] — Assets list in the transaction
      - `tokenId` string, base16, required — Base16-encoded 32 byte digest
      - `amount` integer, required — Amount of the token
    - `additionalRegisters` Registers, required — Ergo box registers
    - `transactionId` string, base16 — Base16-encoded transaction id bytes
    - `index` integer — Index in the transaction outputs
    - `spendingProof` SpendingProof, required — Spending proof for transaction input
      - `proofBytes` string, base16, required — Base16-encoded spending proofs
      - `extension` object, required — Variables to be put into context
  - `dataInputs` ErgoTransactionDataInput[], required — Transaction data inputs
    - `boxId` string, base16, required — Base16-encoded transaction box id bytes. Should be 32 bytes long
  - `outputs` ErgoTransactionOutput[], required — Transaction outputs
    - `boxId` string, base16 — Base16-encoded transaction box id bytes. Should be 32 bytes long
    - `value` integer, required — Amount of Ergo token
    - `ergoTree` string, base16, required — Base16-encoded ergo tree bytes
    - `creationHeight` integer, required — Height the output was created at
    - `assets` Asset[] — Assets list in the transaction
      - `tokenId` string, base16, required — Base16-encoded 32 byte digest
      - `amount` integer, required — Amount of the token
    - `additionalRegisters` Registers, required — Ergo box registers
    - `transactionId` string, base16 — Base16-encoded transaction id bytes
    - `index` integer — Index in the transaction outputs
  - `size` integer, required — Size in bytes

## Other responses

- `default` — Error

## Changes

- **2025-08-08** `ce177636b3e4` — 1 breaking, 5 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the required property `dataInputs` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `inputs` to the response with the `200` status
  - …2 more
- **2025-08-01** `bfbb1772d073` — 8 breaking, 4 warning, 10 info
  - the `items/inputs/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `items/outputs/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `items/inputs/items/boxId` from the response with the `200` status
  - removed the required property `items/inputs/items/spendingProof` from the response with the `200` status
  - …18 more

[Change history](https://skmtc.dev/ergoplatform/apis/ergo-node-api/changes/transactions/unconfirmed/byErgoTree/post.md)

---

[API](https://skmtc.dev/ergoplatform/apis/ergo-node-api.md) · [All operations](https://skmtc.dev/ergoplatform/apis/ergo-node-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ergoplatform/ergo-node-api/revisions/a731602272c6/schema)