---
title: "Returns a list of consensus blocks, sorted from most to least recent."
method: GET
path: "/consensus/blocks"
---

# Returns a list of consensus blocks, sorted from most to least recent.

`GET /consensus/blocks`

## Query parameters

- `limit` integer
- `offset` integer
- `from` integer
- `to` integer
- `after` string, date-time
- `before` string, date-time
- `hash` string

## Response `200`

A JSON object containing a list of consensus blocks.

- BlockList — A list of consensus blocks.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `blocks` Block[], required
    - `height` integer, required — The block height.
    - `hash` string, required — The block header hash.
    - `timestamp` string, date-time, required — The second-granular consensus time.
    - `num_transactions` integer, required — Number of transactions in the block.
    - `gas_limit` string, bigint, required
    - `size_limit` string, bigint
    - `epoch` integer, required — The epoch number of the epoch in which the block was produced.
    - `state_root` string, required — The Merkle root of the state tree after applying the block.

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

## Changes

- **2024-10-25** `51ea4d2cd991` — 1 breaking, 2 warning
  - removed the required property `allOf[subschema #2]/blocks/items/allOf[#/components/schemas/Block]/proposer` from the response with the `200` status
  - deleted the `query` request parameter `proposed_by`
  - removed the optional property `allOf[subschema #2]/blocks/items/allOf[#/components/schemas/Block]/signers` from the response with the `200` status

[Change history](https://skmtc.dev/oasisprotocol/apis/oasis-nexus-api-v1/changes/consensus/blocks/get.md)

---

[API](https://skmtc.dev/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.dev/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/revisions/51ea4d2cd991/schema)