# eth/v1/beacon/states/{state_id}/finality_checkpoints RPC method

Ethereum consensus layer Beacon Chain API call that returns finality checkpoints (opens new window) for the state with the given state_id. If the finality for the state in the call is not yet achieved, the checkpoint returns epoch 0 and ZERO_HASH as root.

Parameters:

  • state_idstring — (required) the state identifier with:
    • head — the canonical head of the chain in the view of the node that you are sending the call to.
    • genesis — the genesis state of the chain.
    • justified — the slot in the current epoch that has received attestations (opens new window) from two thirds of the Ethereum validators.
    • finalized — the previously justified slot that is now in the epoch that is at least immediately previous to the current epoch.
    • slot — the slot number.
    • 0xstateRoot — the root hash for the global chain state after applying changes in the block (opens new window) that is in the slot.

Returns:

  • dataobject with:
    • previous_justifiedobject — the Checkpoint (opens new window) object with:
      • epochstring — the corresponding epoch.
      • rootstring — the corresponding root.
    • current_justifiedobject — the Checkpoint (opens new window) object with:
      • epochstring — the corresponding epoch.
      • rootstring — the corresponding root.
    • final_justifiedobject — the Checkpoint (opens new window) object with:
      • epochstring — the corresponding epoch.
      • rootstring — the corresponding root.

Example:

curl -X GET https://beacon-nd-123-456-789.p2pify.com/3c6e0b8a9c15224a8228b9a98ca1531d/eth/v1/beacon/states/finalized/finality_checkpoints