---
title: "Get block by hash or number"
method: GET
path: "/api/v1/blocks/{hashOrNumber}"
tags: ["blocks"]
---

# Get block by hash or number

`GET /api/v1/blocks/{hashOrNumber}`

Returns the block information by given hash or number.

## Path parameters

- `hashOrNumber` string, required

## Response `200`

OK

- Block
  - `count` integer
  - `gas_used` integer, nullable
  - `hapi_version` string, nullable
  - `hash` string
  - `logs_bloom` string, nullable — A hex encoded 256-byte array with 0x prefix
  - `name` string
  - `number` integer
  - `previous_hash` string
  - `size` integer, nullable
  - `timestamp` TimestampRange — A timestamp range an entity is valid for
    - `from` string — The inclusive from timestamp in seconds
    - `to` string, nullable — The exclusive to timestamp in seconds

## Other responses

- `400` — Invalid parameter
- `404` — Not Found

## Changes

- **2025-08-08** (v1) `db389f03b097` — 9 breaking
  - the response property `_status/messages/items/data` became nullable for the status `400`
  - the response property `_status/messages/items/data` became nullable for the status `404`
  - the response property `_status/messages/items/detail` became nullable for the status `400`
  - the response property `_status/messages/items/detail` became nullable for the status `404`
  - …5 more

[Change history](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/changes/api/v1/blocks/:hashOrNumber/get.md)

---

[API](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiero-ledger/mirror-node-rest-api/revisions/fd141eda79f2/schema)