Blocks

Get Nakamoto block by ID

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}

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

Changed in 14 of the 53 revisions of this API.14536

Jan 28, 202630468ca2533f211See the full diff
- ▲
  for the path request parameter block_id, the minLength was increased from 0 to 64
  request-parameter-min-length-increased
- ▲
  added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id
  request-parameter-pattern-added
- ●
  for the path request parameter block_id, the maxLength was set to 64
  request-parameter-max-length-set
- ○
  added the non-success response with the status 405
  response-non-success-status-added
Jan 14, 2026f7f733b4a1fc3See the full diff
- ○
  for the path request parameter block_id, the minLength was decreased from 64 to 0
  request-parameter-min-length-decreased
- ○
  removed the pattern ^[0-9a-f]{64}$ from the path request parameter block_id
  request-parameter-pattern-removed
- ○
  removed the non-success response with the status 405
  response-non-success-status-removed
Jan 14, 2026eb2153a4a3ad211See the full diff
- ▲
  for the path request parameter block_id, the minLength was increased from 0 to 64
  request-parameter-min-length-increased
- ▲
  added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id
  request-parameter-pattern-added
- ●
  for the path request parameter block_id, the maxLength was set to 64
  request-parameter-max-length-set
- ○
  added the non-success response with the status 405
  response-non-success-status-added
Jan 2, 202696224b968a3e3See the full diff
- ○
  for the path request parameter block_id, the minLength was decreased from 64 to 0
  request-parameter-min-length-decreased
- ○
  removed the pattern ^[0-9a-f]{64}$ from the path request parameter block_id
  request-parameter-pattern-removed
- ○
  removed the non-success response with the status 405
  response-non-success-status-removed
Dec 18, 202597e7080a8130211See the full diff
- ▲
  for the path request parameter block_id, the minLength was increased from 0 to 64
  request-parameter-min-length-increased
- ▲
  added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id
  request-parameter-pattern-added
- ●
  for the path request parameter block_id, the maxLength was set to 64
  request-parameter-max-length-set
- ○
  added the non-success response with the status 405
  response-non-success-status-added
Dec 17, 2025db8094c96a6e3See the full diff
- ○
  for the path request parameter block_id, the minLength was decreased from 64 to 0
  request-parameter-min-length-decreased
- ○
  removed the pattern ^[0-9a-f]{64}$ from the path request parameter block_id
  request-parameter-pattern-removed
- ○
  removed the non-success response with the status 405
  response-non-success-status-removed
Dec 16, 202568660d89e56f211See the full diff
- ▲
  for the path request parameter block_id, the minLength was increased from 0 to 64
  request-parameter-min-length-increased
- ▲
  added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id
  request-parameter-pattern-added
- ●
  for the path request parameter block_id, the maxLength was set to 64
  request-parameter-max-length-set
- ○
  added the non-success response with the status 405
  response-non-success-status-added
Dec 15, 2025d7bba78bfcac3See the full diff
- ○
  for the path request parameter block_id, the minLength was decreased from 64 to 0
  request-parameter-min-length-decreased
- ○
  removed the pattern ^[0-9a-f]{64}$ from the path request parameter block_id
  request-parameter-pattern-removed
- ○
  removed the non-success response with the status 405
  response-non-success-status-removed
Dec 11, 2025f29c78384efe211See the full diff
- ▲
  for the path request parameter block_id, the minLength was increased from 0 to 64
  request-parameter-min-length-increased
- ▲
  added the pattern ^[0-9a-f]{64}$ to the path request parameter block_id
  request-parameter-pattern-added
- ●
  for the path request parameter block_id, the maxLength was set to 64
  request-parameter-max-length-set
- ○
  added the non-success response with the status 405
  response-non-success-status-added
Jul 9, 202504a9a0b50aa314See the full diff
- ▲
  removed the media type application/text-plain for the response with the status 404
  response-media-type-removed
- ○
  api operation id get_block_v3 removed and replaced with getNakamotoBlockById
  api-operation-id-removed
- ○
  added the media type text/plain for the response with the status 404
  response-media-type-added
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the non-success response with the status 500
  response-non-success-status-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (14 revisions)