---
title: "Retrieve boxes by their contract template hash"
method: GET
path: "/blockchain/box/byTemplateHash/{hash}"
tags: ["blockchain"]
---

# Retrieve boxes by their contract template hash

`GET /blockchain/box/byTemplateHash/{hash}`

## Path parameters

- `hash` string, base16, required — Base16-encoded 32 byte modifier id

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

boxes with wanted template hash

- IndexedErgoBox[] — Array of boxes
  - `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
  - `address` string, required — Encoded Ergo Address
  - `spentTransactionId` string, base16, required — Base16-encoded 32 byte modifier id
  - `spendingHeight` integer, nullable, required — The height the box was spent at
  - `inclusionHeight` integer, required — The height the transaction containing the box was included in a block at
  - `spendingProof` SpendingProof — Spending proof for transaction input
    - `proofBytes` string, base16, required — Base16-encoded spending proofs
    - `extension` object, required — Variables to be put into context
  - `globalIndex` integer, required — Global index of the output in the blockchain

## Other responses

- `404` — No boxes found for wanted template hash
- `default` — Error

---

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