---
title: "Changes to Fetch a Nakamoto block by its height and optional tip"
method: GET
path: "/v3/blocks/height/{block_height}"
---

# Changes to Fetch a Nakamoto block by its height and optional tip

`GET /v3/blocks/height/{block_height}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 53 revisions.

- **2026-01-28** `30468ca2533f` — 2 warning
- **2026-01-14** `eb2153a4a3ad` — 2 warning
- **2025-12-18** `97e7080a8130` — 2 warning
- **2025-12-16** `68660d89e56f` — 2 warning
- **2025-12-04** `46bc74e5bab3` — 2 warning
- **2025-07-09** `04a9a0b50aa3` — 1 breaking, 1 warning, 4 info
- **2025-07-08** `488dd3b80020` — 1 breaking, 5 info
- **2025-07-08** `170414634c90` — 1 breaking, 1 warning, 4 info
- **2025-06-26** `2fc5956efe3d` — 1 breaking, 5 info

## Changes

- **2026-01-28** `30468ca2533f` — 2 warning
  - for the `path` request parameter `block_height`, the max was set to `4294967295.00`
  - for the `path` request parameter `block_height`, the min was set to `0.00`
- **2026-01-14** `eb2153a4a3ad` — 2 warning
  - for the `path` request parameter `block_height`, the max was set to `4294967295.00`
  - for the `path` request parameter `block_height`, the min was set to `0.00`
- **2025-12-18** `97e7080a8130` — 2 warning
  - for the `path` request parameter `block_height`, the max was set to `4294967295.00`
  - for the `path` request parameter `block_height`, the min was set to `0.00`
- **2025-12-16** `68660d89e56f` — 2 warning
  - for the `path` request parameter `block_height`, the max was set to `4294967295.00`
  - for the `path` request parameter `block_height`, the min was set to `0.00`
- **2025-12-04** `46bc74e5bab3` — 2 warning
  - for the `path` request parameter `block_height`, the max was set to `4294967295.00`
  - for the `path` request parameter `block_height`, the min was set to `0.00`
- **2025-07-09** `04a9a0b50aa3` — 1 breaking, 1 warning, 4 info
  - removed the media type `application/text-plain` for the response with the status `404`
  - deleted the `query` request parameter `tip`
  - api operation id `get_block_v3_by_height` removed and replaced with `getNakamotoBlockByHeight`
  - added the media type `text/plain` for the response with the status `404`
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
- **2025-07-08** `488dd3b80020` — 1 breaking, 5 info
  - removed the media type `text/plain` for the response with the status `404`
  - api operation id `getNakamotoBlockByHeight` removed and replaced with `get_block_v3_by_height`
  - added the new optional `query` request parameter `tip`
  - added the media type `application/text-plain` for the response with the status `404`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `500`
- **2025-07-08** `170414634c90` — 1 breaking, 1 warning, 4 info
  - removed the media type `application/text-plain` for the response with the status `404`
  - deleted the `query` request parameter `tip`
  - api operation id `get_block_v3_by_height` removed and replaced with `getNakamotoBlockByHeight`
  - added the media type `text/plain` for the response with the status `404`
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
- **2025-06-26** `2fc5956efe3d` — 1 breaking, 5 info
  - removed the media type `text/plain` for the response with the status `404`
  - api operation id `getNakamotoBlockByHeight` removed and replaced with `get_block_v3_by_height`
  - added the new optional `query` request parameter `tip`
  - added the media type `application/text-plain` for the response with the status `404`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/docs/v3/blocks/height/:block_height/get.md) · [API](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api.md) · [Page](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/changes/v3/blocks/height/:block_height/get)
