/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 validators from state

GET https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/states/<state_id>/validators?

Path Parameters

Name	Type	Description
state_id*	String	head

Query Parameters

Name	Type	Description
id	array<string>	1494380
state	array	pending_initialized

200: OK Expand for a detailed response example

{
  "execution_optimistic": true,
  "finalized": false,
  "data": [
    {
      "index": "1494380",
      "balance": "1000000000",
      "status": "pending_initialized",
      "validator": {
        "pubkey": "0x830461a83cd2964e55ebd259763c678bfa008300c99a17681163f82e1f063e3628effa5de0245d270c7c696194705703",
        "withdrawal_credentials": "0x01000000000000000000000003034671b508b2402243931a125957688ba89ff0",
        "effective_balance": "1000000000",
        "slashed": false,
        "activation_eligibility_epoch": "18446744073709551615",
        "activation_epoch": "18446744073709551615",
        "exit_epoch": "18446744073709551615",
        "withdrawable_epoch": "18446744073709551615"
      }
    }
  ]
}

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'