Look up block by height, LT, or timestamp

Look up block by either seqno, lt or unixtime.

GET /lookupBlock

Try it

Look up block by height, LT, or timestamp

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/lookupBlock

200

{
  "ok": true,
  "result": {
    "workchain": 123,
    "shard": "<string>",
    "seqno": 123,
    "root_hash": "<string>",
    "file_hash": "<string>",
    "@type": "ton.blockIdExt"
  },
  "error": "<string>",
  "code": 123
}

Query Parameters

workchain · integer · required

Workchain id to look up block in

shard · integer · required

Shard id to look up block in

seqno · integer

Block's height

lt · integer

Block's logical time

unixtime · integer

Block's unixtime

Response

200

application/json

Successful Response

ok · boolean · required

result · Result · object

Block identifier for the looked-up block.

Show child attributes

result. workchain · integer · required

result. shard · string · required

64-bit signed integer as string

result. seqno · integer · required

result. root_hash · string · required

result. file_hash · string · required

result. @type · string

Example:

"ton.blockIdExt"

error · string

code · integer