---
title: "Get the full block info by a given header id"
method: GET
path: "/blocks/{headerId}"
tags: ["blocks"]
---

# Get the full block info by a given header id

`GET /blocks/{headerId}`

## Path parameters

- `headerId` string, required

## Response `200`

Block object representing the full block data

- FullBlock — Block with header and transactions
  - `header` BlockHeader, required — Header of a block. It authenticates link to a previous block, other block sections (transactions, UTXO set transformation proofs, extension), UTXO set, votes for blockchain parameters to be changed and proof-of-work related data.
    - `id` string, base16, required — Base16-encoded 32 byte modifier id
    - `timestamp` integer, required — Basic timestamp definition
    - `version` integer, required — Ergo blockchain protocol version
    - `adProofsRoot` string, base16, required — Base16-encoded 32 byte digest
    - `stateRoot` string, base16, required — Base16-encoded 33 byte digest - digest with extra byte with tree height
    - `transactionsRoot` string, base16, required — Base16-encoded 32 byte digest
    - `nBits` integer, required — Proof-of-work target (difficulty encoded)
    - `extensionHash` string, base16, required — Base16-encoded 32 byte digest
    - `powSolutions` PowSolutions, required — An object containing all components of pow solution
      - `pk` string, required — Base16-encoded public key
      - `w` string, required
      - `n` string, required
      - `d` number, required
    - `height` integer, required — Height of the block (genesis block height == 1)
    - `difficulty` string, required
    - `parentId` string, base16, required — Base16-encoded 32 byte modifier id
    - `votes` string, base16, required — Base16-encoded votes for a soft-fork and parameters
    - `size` integer — Size of the header in bytes
    - `extensionId` string, base16 — Base16-encoded 32 byte modifier id
    - `transactionsId` string, base16 — Base16-encoded 32 byte modifier id
    - `adProofsId` string, base16 — Base16-encoded 32 byte modifier id
  - `blockTransactions` BlockTransactions, required — Section of a block which contains transactions.
    - `headerId` string, base16, required — Base16-encoded 32 byte modifier id
    - `transactions` ErgoTransaction[], required — List of ErgoTransaction objects
      - `id` string, base16 — Base16-encoded transaction id bytes
      - `inputs` ErgoTransactionInput[], required — Inputs, that will be spent by this transaction
        - `boxId` string, base16, required — Base16-encoded transaction box id bytes. Should be 32 bytes long
        - `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 — Read-only inputs, that are not going to be spent by transaction.
        - `boxId` string, base16, required — Base16-encoded transaction box id bytes. Should be 32 bytes long
      - `outputs` ErgoTransactionOutput[], required — Outputs of the transaction, i.e. box candidates to be created by this transaction.
        - `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 — Size of ErgoTransaction in bytes
    - `size` integer, required — Size in bytes of all block transactions
  - `adProofs` BlockADProofs, required
    - `headerId` string, base16, required — Base16-encoded 32 byte modifier id
    - `proofBytes` string, base16, required — Base16-encoded ad proofs
    - `digest` string, base16, required — Base16-encoded 32 byte digest
    - `size` integer, required — Size in bytes
  - `extension` Extension, required — Section of a block which contains extension data.
    - `headerId` string, base16, required — Base16-encoded 32 byte modifier id
    - `digest` string, base16, required — Base16-encoded 32 byte digest
    - `fields` KeyValueItem[], nullable, required — List of key-value records
      - HexString[] — Key-value record represented as a pair of hex strings in an array.
  - `size` integer, required — Size in bytes

## Other responses

- `404` — Block with this id doesn't exist
- `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)