---
title: "GET /v1/{chainName}/block_v2/{startDate}/{endDate}/"
method: GET
path: "/v1/{chainName}/block_v2/{startDate}/{endDate}/"
tags: ["get-block-heights"]
---

# GET /v1/{chainName}/block_v2/{startDate}/{endDate}/

`GET /v1/{chainName}/block_v2/{startDate}/{endDate}/`

Commonly used to get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day.

## Path parameters

- `chainName` string, required
- `startDate` string, required
- `endDate` string, required

## Query parameters

- `page-size` integer
- `page-number` integer

## Response `200`

Successful response

- object
  - `updated_at` string, date-time — The timestamp when the response was generated. Useful to show data staleness to users.
  - `chain_id` integer — The requested chain ID eg: `1`.
  - `chain_name` string — The requested chain name eg: `eth-mainnet`.
  - `items` object[] — List of response items.
    - `block_hash` string — The hash of the block.
    - `signed_at` string, date-time — The block signed timestamp in UTC.
    - `height` integer — The block height.
    - `block_parent_hash` string — The parent block hash.
    - `extra_data` string — Extra data written to the block.
    - `miner_address` string — The address of the miner.
    - `mining_cost` integer — The associated mining cost.
    - `gas_used` integer — The associated gas used.
    - `gas_limit` integer — The associated gas limit.
    - `transactions_link` string — The link to the related tx by block endpoint.
  - `pagination` object — Pagination metadata.
    - `has_more` boolean — True if there is another page.
    - `page_number` integer — The requested page number.
    - `page_size` integer — The requested number of items on the current page.
    - `total_count` integer — The total number of items across all pages for this request.

---

[API](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis.md) · [All operations](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/covalenthq/goldrush-multichain-data-apis/revisions/c099830c76a0/schema)