---
title: "Get a List of Block Identifiers"
method: GET
path: "/{protocol}/{network}/block_identifiers"
tags: ["Blocks"]
---

# Get a List of Block Identifiers

`GET /{protocol}/{network}/block_identifiers`

Returns a list of minimal block data, block headers such as block hash and block number.

## Path parameters

- `protocol` string, required
- `network` string, required

## Query parameters

- `order` 'desc' | 'asc'
- `page_token` string
- `page_size` integer

## Response `200`

Block headers

- BlockIdentifiers
  - `total` integer — The number of items in block identifiers.
  - `data` BlockIdentifier[]
    - `number` integer — The block number.
    - `id` string — The block hash.
    - `parent_id` string — The parent block hash.
    - `date` integer — The block date in Unix timestamp format.
    - `num_txs` integer — The amount of transaction in the block.
  - `meta` Meta, nullable — The meta details.
    - `paging` Paging — The pagination details.
      - `next_page_token` string — The next page token to use in the following request.

## Other responses

- `400` — Bad request
- `401` — Invalid or expired token
- `429` — Rate limit exceeded
- `500` — An internal server error happened
- `503` — The resource you are trying to access is currently unavailable

---

[API](https://skmtc.dev/blockdaemon/apis/staking-api.md) · [All operations](https://skmtc.dev/blockdaemon/apis/staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blockdaemon/staking-api/revisions/f94e296a08a3/schema)