Skip to main content
GET
/
0a9d79d93fb2f4a4b1e04695da2b77a7
/
eth
/
v1
/
beacon
/
states
/
{state_id}
/
finality_checkpoints
Get finality checkpoints for a given state
curl --request GET \
  --url https://beacon-nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7/eth/v1/beacon/states/{state_id}/finality_checkpoints
{
  "previous_justified": {
    "epoch": 123,
    "root": "aSDinaTvuI8gbWludGxpZnk="
  },
  "current_justified": {
    "epoch": 123,
    "root": "aSDinaTvuI8gbWludGxpZnk="
  },
  "finalized": {
    "epoch": 123,
    "root": "aSDinaTvuI8gbWludGxpZnk="
  }
}
The /eth/v1/beacon/states/{state_id}/finality_checkpoints endpoint retrieves the finality checkpoints of a specified Beacon Chain state. These checkpoints are critical in understanding the finality status of various epochs in the Ethereum PoS mechanism.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • state_id — the state identifier for which finality checkpoint information is requested. Acceptable values for state_id include:
    • head — represents the current head of the chain from the node’s perspective.
    • genesis — the genesis state of the Beacon Chain.
    • finalized — the most recent state that has been finalized and is unlikely to undergo any further changes.
    • justified — the most recent state that has been justified, which is a stage preceding finalization.
    • <slot> — a specific time slot in the Ethereum protocol.
    • <hex encoded stateRoot with 0x prefix> — the specific state root, encoded in hexadecimal.

​
Response

The response includes an object with the following properties:
  • data — an object containing finality checkpoint information for the specified state:
    • previous_justified — an object representing the last justified checkpoint before the current epoch. It contains:
      • epoch — the epoch number of this justified checkpoint.
      • root — the block root of this justified checkpoint.
    • current_justified — an object representing the current justified checkpoint. It contains:
      • epoch — the epoch number of the current justified checkpoint.
      • root — the block root of the current justified checkpoint.
    • finalized — an object representing the current finalized checkpoint. It contains:
      • epoch — the epoch number of the finalized checkpoint.
      • root — the block root of the finalized checkpoint.

Path Parameters

​
state_id
string
default:head
required

State identifier which can be a slot number, an epoch number, a block root, or 'genesis', 'head' (default is 'head').

Response

Successful response with finality checkpoints information

​
previous_justified
object
​
current_justified
object
​
finalized
object
Last modified on August 7, 2025