Skip to main content

/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​

FieldTypeDescription
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

idarray<string>Either hex encoded public key (any bytes48 with 0x prefix) or validator index
statusarrayAvailable values : pending_initialized, pending_queued, active_ongoing, active_exiting, active_slashed, exited_unslashed, exited_slashed, withdrawal_possible, withdrawal_done, active, pending, exited, withdrawal
info

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
info

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!

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'