v1

latestOpenAPI 3.0.2CC0 1.0 Universal2026-07-17128129208.3 KB
blocks

Get the block header info by a given header id

get/blocks/{headerId}/header

Path parameters

headerIdstring required

ID of a wanted block header

Response

Block header object

idstring base16 required

Base16-encoded 32 byte modifier id

timestampinteger required

Basic timestamp definition

versioninteger required

Ergo blockchain protocol version

adProofsRootstring base16 required

Base16-encoded 32 byte digest

stateRootstring base16 required

Base16-encoded 33 byte digest - digest with extra byte with tree height

transactionsRootstring base16 required

Base16-encoded 32 byte digest

nBitsinteger required

Proof-of-work target (difficulty encoded)

extensionHashstring base16 required

Base16-encoded 32 byte digest

heightinteger required

Height of the block (genesis block height == 1)

difficultystring required
parentIdstring base16 required

Base16-encoded 32 byte modifier id

votesstring base16 required

Base16-encoded votes for a soft-fork and parameters

sizeinteger

Size of the header in bytes

extensionIdstring base16

Base16-encoded 32 byte modifier id

transactionsIdstring base16

Base16-encoded 32 byte modifier id

adProofsIdstring base16

Base16-encoded 32 byte modifier id

Example response

{
  "id": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "timestamp": 1524143059077,
  "version": 2,
  "adProofsRoot": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "stateRoot": "333ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "transactionsRoot": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "nBits": 19857408,
  "extensionHash": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "powSolutions": {
    "pk": "0350e25cee8562697d55275c96bb01b34228f9bd68fd9933f2a25ff195526864f5",
    "w": "0366ea253123dfdb8d6d9ca2cb9ea98629e8f34015b1e4ba942b1d88badfcc6a12",
    "n": "0000000000000000",
    "d": 987654321
  },
  "height": 667,
  "difficulty": "9575989248",
  "parentId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "votes": "000000",
  "extensionId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "transactionsId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
  "adProofsId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117"
}