---
title: "Get block number by time stamp"
method: GET
path: "/{chain_id}/api/legacy/block/get-block-number-by-time"
tags: ["legacy"]
---

# Get block number by time stamp

`GET /{chain_id}/api/legacy/block/get-block-number-by-time`

Returns the block number created closest to a provided timestamp.

Required:
- `timestamp`
- `closest`

## Path parameters

- `chain_id` string, required

## Query parameters

- `timestamp` string
- `closest` 'before' | 'after'

## Response `200`

Block number

- object
  - `message` string, required — Human-readable status string — `OK` on success, a descriptive error message otherwise.
  - `result` GetBlockNumberByTimeResult, nullable, required — Block number closest to the requested timestamp; `null` if the lookup fails.
    - `blockNumber` string, required — Decimal-string block number.
  - `status` '0' | '1' | '2', required — `1` = OK, `0` = error, `2` = pending.

---

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