Blocks

Get Nakamoto block by ID

Changed on

Get a specific Nakamoto block (Stacks 3.x+) by its index block hash. This endpoint streams the block data from the Nakamoto staging blocks database where Nakamoto blocks are stored with additional metadata including tenure information.

Compatibility: Works with Nakamoto blocks only. For Stacks 2.x blocks, use /v2/blocks/{block_id}.

get/v3/blocks/{block_id}

Request

  • Base URL
    http://localhost:20443
  • URL
    http://localhost:20443/v3/blocks/{block_id}
  • Auth
    none required

Path parameters

block_idstring required
Example:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

The block's ID hash (64-character hex string)

Response

The raw SIP-003-encoded block will be returned.

Changes

  • 30468ca2533fRevision changes
    • breaking

      for the path request parameter block_id, the minLength was increased from 0 to 64

    • breaking

      added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id

    • warning

      for the path request parameter block_id, the maxLength was set to 64

    • info

      added the non-success response with the status

  • f7f733b4a1fcRevision changes
    • info

      for the path request parameter block_id, the minLength was decreased from 64 to 0

    • info

      removed the pattern ^[0-9a-f]{64}$ from the path request parameter block_id

    • info

      removed the non-success response with the status