Links

/eth/v1/beacon/states/{state_id}/validators

Get validators from state
Providing a list of validators that may be filtered according to their balance, status, and index.
For each index or public key that matches a known validator, information will be returned. No information will be returned but there won't be an error if an index or public key doesn't match any known validator. The index and public key are returned for each validator and can be used to verify for which inputs a response has been returned; however, there are no guarantees on the ordering of the returned data.

Example Request and Result for /v1/beacon/states/{state_id}/validators

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/beacon/states/{state_id}/validators endpoint. Additionally, we present the resulting response containing information about state's validators.

Parameters

Field
Type
Description
state_id*
string
State identifier. Can be one of: "head" (canonical head in node's view), "genesis", "finalized", "justified", <slot>, <hex encoded stateRoot with 0x prefix>.
Example : head
id
array<string>
Either hex encoded public key (any bytes48 with 0x prefix) or validator index
status
array
Available values : pending_initialized, pending_queued, active_ongoing, active_exiting, active_slashed, exited_unslashed, exited_slashed, withdrawal_possible, withdrawal_done, active, pending, exited, withdrawal
Additional info about the status epoch:
  • activation_eligibility_epoch: When criteria for activation were met
  • activation_epoch: When the validator is/was scheduled to activate. May change while in the activation queue.
  • exit_epoch: When the validator is/was scheduled to exit. May change while exiting.
  • withdrawable_epoch: When validator can withdraw funds
The example in this section uses a non-existing project id.
Make sure you replace it with your Ethereum Holesky Beacon endpoint when issuing the API calls.
Don't have a project id? Here's a straightforward guide on how to obtain one!
get
https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/states/<state_id>/validators?
Get validators from state
Parameters
Path
state_id*
head
Query
id
array<string>
1494380
state
array
pending_initialized
Responses
200: OK
Expand for a detailed response example

Curl Request example

curl -X 'GET' \
'https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/states/head/validators?id=1494380&status=pending_initialized' \
-H 'accept: application/json'