---
title: "Returns a validator registered at the consensus layer."
method: GET
path: "/consensus/validators/{address}"
---

# Returns a validator registered at the consensus layer.

`GET /consensus/validators/{address}`

## Path parameters

- `address` string, required — An Oasis-style (bech32) address.

## Response `200`

A JSON object containing a validator registered at the
consensus layer.

- ValidatorList — A list of validators registered at the consensus layer, plus summary statistics across all consensus validators.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `validators` Validator[], required
    - `entity_address` string, required — The staking address identifying this validator.
    - `entity_id` string, required — The public key identifying this validator.
    - `node_id` string — The public key identifying this validator's node.
    - `escrow` Escrow, required
      - `active_balance` string, bigint
      - `active_shares` string, bigint
      - `debonding_balance` string, bigint
      - `debonding_shares` string, bigint
      - `self_delegation_balance` string, bigint
      - `self_delegation_shares` string, bigint
      - `active_balance_24` string, bigint
      - `num_delegators` integer — The number of accounts that have delegated token to this account.
    - `voting_power` integer, required — The voting power of this validator.
    - `voting_power_cumulative` integer — The cumulative voting power of this validator and all other validators ranked higher than itself.
    - `active` boolean, required — Whether the entity has a node that is registered for being a validator, node is up to date, and has successfully registered itself. It may or may not be part of validator set.
    - `start_date` string, required — The second-granular consensus time.
    - `rank` integer, required — The rank of the validator, determined by voting power.
    - `in_validator_set` boolean, required — Whether the entity is part of the validator set (top <scheduler.params.max_validators> by stake among active entities).
    - `media` ValidatorMedia
      - `url` string — An URL associated with the entity.
      - `email` string — An email address associated with the entity.
      - `twitter` string — Twitter handle.
      - `keybase` string — Keybase handle.
      - `name` string — The human-readable name of this entity.
      - `logoUrl` string — URL to a logo image for the entity.
    - `current_rate` integer, required — Commission rate.
    - `current_commission_bound` ValidatorCommissionBound, required
      - `lower` integer, required
      - `upper` integer, required
      - `epoch_start` integer, required
      - `epoch_end` integer, required
    - `signed_blocks` ValidatorSignedBlock[] — An array containing details of the last 100 consensus blocks, indicating whether each block was signed by the validator. Only available when querying a single validator.
      - `height` integer, required — The block height.
      - `signed` boolean, required — Whether the validator signed the block.
  - `stats` ValidatorAggStats, required
    - `total_voting_power` integer, required — The total voting power across all validators.
    - `total_delegators` integer, required — The total number of delegators in the network.
    - `total_staked_balance` string, bigint, required

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)