Skip to main content

/eth/v1/beacon/states/{state_id}/finality_checkpoints REST API Endpoint

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

Updated on
May 21, 2026

Path Parameters

state_id
string
REQUIRED

The state identifier. It can be one of: head (canonical head in node's view), genesis, finalized, justified, slot and stateRoot (hex encoded stateRoot with 0x prefix)

Returns

execution_optimistic
Boolean

It's true if the response references an unverified execution payload. The optimistic information may be invalidated at a later time. If the field is not present, assume the false value

data
object

The object with the following values:

previous_justified
array

The Checkpoint

epoch
string

The corresponding epoch

root
string

The corresponding root

current_justified
array

The Checkpoint

epoch
string

The corresponding epoch

root
string

The corresponding root

final_justified
array

The Checkpoint

epoch
string

The corresponding epoch

root
string

The corresponding root

Request
Response
1
{
2
"execution_optimistic": false,
3
"finalized": false,
4
"data": {
5
"previous_justified": {
6
"epoch": "362031",
7
"root": "0x73b5a6d2eaa71fa6b9377672f5635127e12a6f2e55609c5f2eb1c4dd4c3d4d57"
8
},
9
"current_justified": {
10
"epoch": "362032",
11
"root": "0x69078f161082cbddcbbf6d2abe605f3a1f56005dac5300ff15bf8b3961d67643"
12
},
13
"finalized": {
14
"epoch": "362031",
15
"root": "0x73b5a6d2eaa71fa6b9377672f5635127e12a6f2e55609c5f2eb1c4dd4c3d4d57"
16
}
17
}
18
}
1
{
2
"execution_optimistic": false,
3
"finalized": false,
4
"data": {
5
"previous_justified": {
6
"epoch": "362031",
7
"root": "0x73b5a6d2eaa71fa6b9377672f5635127e12a6f2e55609c5f2eb1c4dd4c3d4d57"
8
},
9
"current_justified": {
10
"epoch": "362032",
11
"root": "0x69078f161082cbddcbbf6d2abe605f3a1f56005dac5300ff15bf8b3961d67643"
12
},
13
"finalized": {
14
"epoch": "362031",
15
"root": "0x73b5a6d2eaa71fa6b9377672f5635127e12a6f2e55609c5f2eb1c4dd4c3d4d57"
16
}
17
}
18
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free