---
title: "Get state finality checkpoints"
method: GET
path: "/eth/v1/beacon/states/{state_id}/finality_checkpoints"
tags: ["Beacon"]
---

# Get state finality checkpoints

`GET /eth/v1/beacon/states/{state_id}/finality_checkpoints`

## Request

- Base URL: `eth2-beacon-mainnet.nodereal.io/v1/api_key` (relative, and the document’s source URL is not known)
- URL: `eth2-beacon-mainnet.nodereal.io/v1/api_key/eth/v1/beacon/states/{state_id}/finality_checkpoints`
- Auth: none declared

Returns finality checkpoints for state with given 'stateId'.
In case finality is not yet achieved, checkpoint should return epoch 0 and ZERO_HASH as root.

## Path parameters

- `state_id` string, required

## Response `200`

Success

- object
  - `execution_optimistic` boolean: True if the response references an unverified execution payload. Optimistic information may be invalidated at a later time. If the field is not present, assume the False value.
  - `data` object
    - `previous_justified` object: The [`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
      - `epoch` string
      - `root` string
    - `current_justified` object: The [`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
      - `epoch` string
      - `root` string
    - `finalized` object: The [`Checkpoint`](https://github.com/ethereum/consensus-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#checkpoint
      - `epoch` string
      - `root` string

## Other responses

- `400`: Invalid state ID
- `404`: State not found
- `500`: Beacon node internal error.

---

[API](https://skmtc.dev/nodereal/apis/eth-beacon-node-api.md) - [All operations](https://skmtc.dev/nodereal/apis/eth-beacon-node-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodereal/apis/eth-beacon-node-api/revisions/1878ea8657a1?raw)
