---
title: "Changes to Retrieve boxes by their associated ergotree"
method: POST
path: "/blockchain/box/byErgoTree"
---

# Changes to Retrieve boxes by their associated ergotree

`POST /blockchain/box/byErgoTree`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 109 revisions.

- **2026-10-04** `472c81ac38eb`: 1 info
- **2025-06-19** `a0078a982142`: 1 info
- **2025-06-19** `9311aadf9550`: 1 warning
- **2025-06-16** `c19bff6509da`: 1 info
- **2023-10-17** `2b9e28478bd4`: 10 breaking, 1 info
- **2023-10-17** `e4beb626254a`: 1 breaking, 10 info
- **2023-10-04** `a1e48d573664`: 10 breaking, 1 info
- **2023-10-04** `921e775025a4`: 1 breaking, 10 info
- **2023-10-03** `855e175a2131`: 10 breaking, 1 info
- **2023-09-29** `7f421439f73d`: 1 breaking, 10 info
- **2023-09-19** `97dcd305a93d`: 10 breaking, 1 info

## Changes

- **2026-10-04** `472c81ac38eb`: 1 info
  - added the non-success response with the status `503`
- **2025-06-19** `a0078a982142`: 1 info
  - added the optional property `items/items/allOf[subschema #2]/spendingProof` to the response with the `200` status
- **2025-06-19** `9311aadf9550`: 1 warning
  - removed the optional property `items/items/allOf[subschema #2]/spendingProof` from the response with the `200` status
- **2025-06-16** `c19bff6509da`: 1 info
  - added the optional property `items/items/allOf[subschema #2]/spendingProof` to the response with the `200` status
- **2023-10-17** `2b9e28478bd4`: 10 breaking, 1 info
  - the `items/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/address` from the response with the `200` status
  - removed the required property `items/items/box` from the response with the `200` status
  - removed the required property `items/items/confirmationsNum` from the response with the `200` status
  - removed the required property `items/items/creationTransaction` from the response with the `200` status
  - removed the required property `items/items/globalIndex` from the response with the `200` status
  - removed the required property `items/items/inclusionHeight` from the response with the `200` status
  - removed the required property `items/items/spendingHeight` from the response with the `200` status
  - removed the required property `items/items/spendingTransaction` from the response with the `200` status
  - removed the required property `items/items/spent` from the response with the `200` status
  - added `#/components/schemas/ErgoTransactionOutput, subschema #2` to the `items/items/` response property `allOf` list for the response status `200`
- **2023-10-17** `e4beb626254a`: 1 breaking, 10 info
  - the `items/items/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/ErgoTransactionOutput, subschema #2` from the `items/items/` response property `allOf` list for the response status `200`
  - added the required property `items/items/address` to the response with the `200` status
  - added the required property `items/items/box` to the response with the `200` status
  - added the required property `items/items/confirmationsNum` to the response with the `200` status
  - added the required property `items/items/creationTransaction` to the response with the `200` status
  - added the required property `items/items/globalIndex` to the response with the `200` status
  - added the required property `items/items/inclusionHeight` to the response with the `200` status
  - added the required property `items/items/spendingHeight` to the response with the `200` status
  - added the required property `items/items/spendingTransaction` to the response with the `200` status
  - added the required property `items/items/spent` to the response with the `200` status
- **2023-10-04** `a1e48d573664`: 10 breaking, 1 info
  - the `items/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/address` from the response with the `200` status
  - removed the required property `items/items/box` from the response with the `200` status
  - removed the required property `items/items/confirmationsNum` from the response with the `200` status
  - removed the required property `items/items/creationTransaction` from the response with the `200` status
  - removed the required property `items/items/globalIndex` from the response with the `200` status
  - removed the required property `items/items/inclusionHeight` from the response with the `200` status
  - removed the required property `items/items/spendingHeight` from the response with the `200` status
  - removed the required property `items/items/spendingTransaction` from the response with the `200` status
  - removed the required property `items/items/spent` from the response with the `200` status
  - added `#/components/schemas/ErgoTransactionOutput, subschema #2` to the `items/items/` response property `allOf` list for the response status `200`
- **2023-10-04** `921e775025a4`: 1 breaking, 10 info
  - the `items/items/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/ErgoTransactionOutput, subschema #2` from the `items/items/` response property `allOf` list for the response status `200`
  - added the required property `items/items/address` to the response with the `200` status
  - added the required property `items/items/box` to the response with the `200` status
  - added the required property `items/items/confirmationsNum` to the response with the `200` status
  - added the required property `items/items/creationTransaction` to the response with the `200` status
  - added the required property `items/items/globalIndex` to the response with the `200` status
  - added the required property `items/items/inclusionHeight` to the response with the `200` status
  - added the required property `items/items/spendingHeight` to the response with the `200` status
  - added the required property `items/items/spendingTransaction` to the response with the `200` status
  - added the required property `items/items/spent` to the response with the `200` status
- **2023-10-03** `855e175a2131`: 10 breaking, 1 info
  - the `items/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/address` from the response with the `200` status
  - removed the required property `items/items/box` from the response with the `200` status
  - removed the required property `items/items/confirmationsNum` from the response with the `200` status
  - removed the required property `items/items/creationTransaction` from the response with the `200` status
  - removed the required property `items/items/globalIndex` from the response with the `200` status
  - removed the required property `items/items/inclusionHeight` from the response with the `200` status
  - removed the required property `items/items/spendingHeight` from the response with the `200` status
  - removed the required property `items/items/spendingTransaction` from the response with the `200` status
  - removed the required property `items/items/spent` from the response with the `200` status
  - added `#/components/schemas/ErgoTransactionOutput, subschema #2` to the `items/items/` response property `allOf` list for the response status `200`
- **2023-09-29** `7f421439f73d`: 1 breaking, 10 info
  - the `items/items/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/ErgoTransactionOutput, subschema #2` from the `items/items/` response property `allOf` list for the response status `200`
  - added the required property `items/items/address` to the response with the `200` status
  - added the required property `items/items/box` to the response with the `200` status
  - added the required property `items/items/confirmationsNum` to the response with the `200` status
  - added the required property `items/items/creationTransaction` to the response with the `200` status
  - added the required property `items/items/globalIndex` to the response with the `200` status
  - added the required property `items/items/inclusionHeight` to the response with the `200` status
  - added the required property `items/items/spendingHeight` to the response with the `200` status
  - added the required property `items/items/spendingTransaction` to the response with the `200` status
  - added the required property `items/items/spent` to the response with the `200` status
- **2023-09-19** `97dcd305a93d`: 10 breaking, 1 info
  - the `items/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/address` from the response with the `200` status
  - removed the required property `items/items/box` from the response with the `200` status
  - removed the required property `items/items/confirmationsNum` from the response with the `200` status
  - removed the required property `items/items/creationTransaction` from the response with the `200` status
  - removed the required property `items/items/globalIndex` from the response with the `200` status
  - removed the required property `items/items/inclusionHeight` from the response with the `200` status
  - removed the required property `items/items/spendingHeight` from the response with the `200` status
  - removed the required property `items/items/spendingTransaction` from the response with the `200` status
  - removed the required property `items/items/spent` from the response with the `200` status
  - added `#/components/schemas/ErgoTransactionOutput, subschema #2` to the `items/items/` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/ergoplatform/apis/ergo-node-api/docs/blockchain/box/byErgoTree/post.md) - [API](https://skmtc.dev/ergoplatform/apis/ergo-node-api.md) - [Page](https://skmtc.dev/ergoplatform/apis/ergo-node-api/changes/blockchain/box/byErgoTree/post)
