---
title: "Get a paginated list of blocks."
method: GET
path: "/api/v1/blocks"
tags: ["block"]
---

# Get a paginated list of blocks.

`GET /api/v1/blocks`

Returns blocks with pagination metadata.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Paginated response with data and pagination metadata

- ExtendedResponse — It's used for endpoints that return lists of items requiring pagination.
  - `data` unknown
  - `pagination` Pagination — It provides information about the current page and total available records.
    - `limit` integer — Limit indicates the maximum number of items per page
    - `offset` integer — Offset indicates the starting position in the full dataset
    - `totalRecords` integer — TotalRecords indicates the total number of available records

## Other responses

- `400` — Error response
- `500` — Error response

---

[API](https://skmtc.net/bsv-blockchain/apis/teranode-asset-service-api.md) · [All operations](https://skmtc.net/bsv-blockchain/apis/teranode-asset-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bsv-blockchain/teranode-asset-service-api/versions/5bc9be41e029/schema)