---
title: "Get countdown information for a target block number"
method: GET
path: "/{chain_id}/api/v2/blocks/{block_number_param}/countdown"
tags: ["blocks"]
---

# Get countdown information for a target block number

`GET /{chain_id}/api/v2/blocks/{block_number_param}/countdown`

Calculates the estimated time remaining until a specified block number is reached based on current block and average block time.

## Path parameters

- `block_number_param` integer, required
- `chain_id` string, required

## Response `200`

Block countdown information.

- BlockCountdown — Block countdown information showing estimated time until a target block is reached
  - `countdown_block` integer, required — The target block number for the countdown
  - `current_block` integer, required — The current highest block number in the blockchain
  - `estimated_time_in_sec` number, float, required — Estimated time in seconds until the target block is reached
  - `remaining_blocks` integer, required — Number of blocks remaining until the target block is reached

## Other responses

- `404` — Not Found
- `422` — Unprocessable Entity

---

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