Skip to main content
POST
/
api
/
v1
/
validator
Validators overview (POST)
curl --request POST \
  --url 'https://beaconcha.in/api/v1/validator?apikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "indicesOrPubkey": "1,2,3"
}
'
{ "status": "OK", "data": [ { "activation_eligibility_epoch": 289892, "activation_epoch": 290297, "balance": 32014494648, "effective_balance": 32000000000, "exit_epoch": 9223372036854776000, "last_attestation_slot": 12766062, "name": "name", "pubkey": "0xb73ecd964c9779506a3209ec40dd40d765b0464fef281d77ac8a559fa9e2a9cff8b6b2e09b8f6360b119ba7a963c5b81", "slashed": false, "status": "active_online", "validator_index": 1435245, "withdrawable_epoch": 9223372036854776000, "withdrawal_credentials": "0x0100000000000000000000005d652886f0b4ae0b1b7d6be5b7e2d555aafdc812", "total_withdrawals": 1072078769 } ] }

Authorizations

​
apikey
string
query
required

Body

application/json

Comma-separated list of validator indices and/or public keys to query (maximum 100 items by default).

Validator lookup request specifying validator indices and/or public keys.

​
indicesOrPubkey
string
required

Comma-separated list (no spaces) of validator identifiers. Each identifier must be either:

  • A validator index as a base-10 integer (for example, 652648)
  • A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Resolution and limits:

  • The server resolves public keys to validator indices before querying data.
  • The total number of identifiers must not exceed the server-enforced limit (default 100).
  • Identifiers that cannot be parsed or resolved result in HTTP 400.
Example:

"1,2,3"

Response

Matching validators were retrieved successfully. The data field contains either a single validator object (when one identifier is provided/resolved) or an array of validator objects (when multiple identifiers are provided/resolved).

Standard success envelope used by all API endpoints.

​
status
enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:
OK
​
data
object

State and metadata for a single validator, including status, balances, epochs, and withdrawal summary.