---
title: "Changes to Retrieve unspent boxes by an associated token id"
method: GET
path: "/blockchain/box/unspent/byTokenId/{tokenId}"
---

# Changes to Retrieve unspent boxes by an associated token id

`GET /blockchain/box/unspent/byTokenId/{tokenId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 59 revisions.

- **2025-07-31** `04463b9c8c11` — 1 info
- **2025-06-05** `c19bff6509da` — 1 info
- **2023-10-17** `2b9e28478bd4` — 1 info
- **2023-10-04** `c08c8756d712` — 1 breaking
- **2023-10-04** `a1e48d573664` — 1 info

## Changes

- **2025-07-31** `04463b9c8c11` — 1 info
  - added the new optional `query` request parameter `excludeMempoolSpent`
- **2025-06-05** `c19bff6509da` — 1 info
  - added the optional property `items/allOf[subschema #2]/spendingProof` to the response with the `200` status
- **2023-10-17** `2b9e28478bd4` — 1 info
  - endpoint added
- **2023-10-04** `c08c8756d712` — 1 breaking
  - api path removed without deprecation
- **2023-10-04** `a1e48d573664` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ergoplatform/apis/ergo-node-api/docs/blockchain/box/unspent/byTokenId/:tokenId/get.md) · [API](https://skmtc.dev/ergoplatform/apis/ergo-node-api.md) · [Page](https://skmtc.dev/ergoplatform/apis/ergo-node-api/changes/blockchain/box/unspent/byTokenId/:tokenId/get)