---
title: "Validators queries all validators that match the given status."
method: GET
path: "/cosmos/staking/v1beta1/validators"
tags: ["Query"]
---

# Validators queries all validators that match the given status.

`GET /cosmos/staking/v1beta1/validators`

When called from another module, this query might consume a high amount of
gas if the pagination field is incorrectly set.

## Query parameters

- `status` string
- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- CosmosStakingV1beta1QueryValidatorsResponse
  - `pagination` CosmosBaseQueryV1beta1PageResponse — PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte — next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64
  - `validators` CosmosStakingV1beta1Validator[] — validators contains all the queried validators.
    - `commission` CosmosStakingV1beta1Commission — Commission defines commission parameters for a given validator.
      - `commission_rates` CosmosStakingV1beta1CommissionRates — CommissionRates defines the initial commission rates to be used for creating a validator.
        - `max_change_rate` string — max_change_rate defines the maximum daily increase of the validator commission, as a fraction.
        - `max_rate` string — max_rate defines the maximum commission rate which validator can ever charge, as a fraction.
        - `rate` string — rate is the commission rate charged to delegators, as a fraction.
      - `update_time` string, date-time — update_time is the last time the commission rate was changed.
    - `consensus_pubkey` GoogleProtobufAny
      - `@type` string
    - `delegator_shares` string — delegator_shares defines total shares issued to a validator's delegators.
    - `description` CosmosStakingV1beta1Description — Description defines a validator description.
      - `details` string — details define other optional details.
      - `identity` string — identity defines an optional identity signature (ex. UPort or Keybase).
      - `moniker` string — moniker defines a human-readable name for the validator.
      - `security_contact` string — security_contact defines an optional email for security contact.
      - `website` string — website defines an optional website link.
    - `jailed` boolean — jailed defined whether the validator has been jailed from bonded status or not.
    - `min_self_delegation` string — min_self_delegation is the validator's self declared minimum self delegation. Since: cosmos-sdk 0.46
    - `operator_address` string — operator_address defines the address of the validator's operator; bech encoded in JSON.
    - `status` 'BOND_STATUS_UNSPECIFIED' | 'BOND_STATUS_UNBONDED' | 'BOND_STATUS_UNBONDING' | 'BOND_STATUS_BONDED' — BondStatus is the status of a validator. - BOND_STATUS_UNSPECIFIED: UNSPECIFIED defines an invalid validator status. - BOND_STATUS_UNBONDED: UNBONDED defines a validator that is not bonded. - BOND_STATUS_UNBONDING: UNBONDING defines a validator that is unbonding. - BOND_STATUS_BONDED: BONDED defines a validator that is bonded.
    - `tokens` string — tokens define the delegated tokens (incl. self-delegation).
    - `unbonding_height` string, int64 — unbonding_height defines, if unbonding, the height at which this validator has begun unbonding.
    - `unbonding_ids` string[]
    - `unbonding_on_hold_ref_count` string, int64
    - `unbonding_time` string, date-time — unbonding_time defines, if unbonding, the min time for the validator to complete unbonding.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2025-02-05** `de0653d8a73d` — 1 info
  - api operation id `EvidenceQuery_Validators` removed and replaced with `CircuitQuery_Validators`
- **2024-08-14** `21c607e4fa20` — 1 info
  - endpoint added
- **2024-07-31** `19416a3f0cd1` — 1 breaking
  - api path removed without deprecation
- **2024-07-11** `ca7e84576c8e` — 1 info
  - endpoint added
- **2024-05-15** `41fb8b09e244` — 1 breaking
  - api path removed without deprecation

[Full history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos/staking/v1beta1/validators/get.md)

---

[API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pokt-network/http-api-console/revisions/de0653d8a73d/schema)