---
title: "Retrieve checkpoint"
method: GET
path: "/consensus/checkpoint/{id}"
tags: ["consensus"]
---

# Retrieve checkpoint

`GET /consensus/checkpoint/{id}`

Returns the consensus state and block for a given block ID.

## Path parameters

- `id` string, required — 256-bit blake2b hash.

## Response `200`

Matching checkpoint.

- ConsensusCheckpointResponse
  - `state` ConsensusState, required — Snapshot of consensus state at a given tip.
    - `index` ChainIndex, required
      - `height` integer, required — Block height.
      - `id` string, required — 256-bit blake2b hash.
    - `prevTimestamps` string[], required — Recent block timestamps from newest to oldest.
    - `depth` string, required — 256-bit blake2b hash.
    - `childTarget` string, required — 256-bit blake2b hash.
    - `siafundTaxRevenue` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `oakTime` string, required — Oak target window as a Go duration string.
    - `oakTarget` string, required — 256-bit blake2b hash.
    - `foundationSubsidyAddress` string, required — Human-readable Sia address.
    - `foundationManagementAddress` string, required — Human-readable Sia address.
    - `totalWork` string, required — Quantity of work encoded as a decimal string.
    - `difficulty` string, required — Quantity of work encoded as a decimal string.
    - `oakWork` string, required — Quantity of work encoded as a decimal string.
    - `elements` ElementAccumulator, required — Sparse Merkle forest tracking consensus elements.
      - `numLeaves` integer, required — Number of leaves represented by the accumulator.
      - `trees` Hash256[], required — Merkle roots for the populated accumulator trees in ascending height order.
    - `attestations` integer, required
  - `block` object, required — Full block at the specified block ID.

## Other responses

- `404` — Block not found.

---

[API](https://skmtc.net/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.net/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/versions/08ff756929fc/schema)