Parameters

Object Name	Required	Type	Detail
`status`	❌	String	Status enables to query for validators matching a given status.
`pagination.key`	❌	String	The value returned in `PageResponse.next_key` to begin querying the next page most efficiently. If provided, then `pagination.offset` is not allowed.
`pagination.offset`	❌	Integer	A numeric offset that can be used when `pagination.key` is unavailable. It is less efficient than `pagination.key`. If provided, then `pagination.key` is not allowed.
`pagination.limit`	❌	Integer	The total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.
`pagination.count_total`	❌	Boolean	If set to `true`, the result will include a count of the total number of items available for pagination. `count_total` is only respected when `offset` is used. It is ignored when `key` is set.

/cosmos/staking/v1beta1/validators?pagination.limit=2

Result

All validators that match the given status.

Example

Request

curl <your-rest-endpoint>/cosmos/staking/v1beta1/validators?pagination.limit=2 \
  -X GET \
  -H "accept: application/json"

Return

{
    "validators": [
        {
            "operator_address": "cosmosvaloper1qphf0ferqcch0jca9hlqfm3x0eds3dpkcvpafp",
            "consensus_pubkey": {
                "@type": "/cosmos.crypto.ed25519.PubKey",
                "key": "voVoXB0ArzZ57NgZgyAhrwa0mVabPijeqT0ebQJYPPc="
            },
            "jailed": false,
            "status": "BOND_STATUS_UNBONDED",
            "tokens": "1000000",
            "delegator_shares": "1000000.000000000000000000",
            "description": {
                "moniker": "test kim",
                "identity": "",
                "website": "",
                "security_contact": "",
                "details": ""
            },
            "unbonding_height": "0",
            "unbonding_time": "1970-01-01T00:00:00Z",
            "commission": {
                "commission_rates": {
                    "rate": "0.100000000000000000",
                    "max_rate": "0.200000000000000000",
                    "max_change_rate": "0.010000000000000000"
                },
                "update_time": "2022-12-20T07:59:27.494716670Z"
            },
            "min_self_delegation": "1000000"
        },
        {
            "operator_address": "cosmosvaloper1q9p73lx07tjqc34vs8jrsu5pg3q4ha534uqv4w",
            "consensus_pubkey": {
                "@type": "/cosmos.crypto.ed25519.PubKey",
                "key": "Y3FwPLeVHUhR+Or59OJ1SCq0OiS/tBye2YdKA3dzy/s="
            },
            "jailed": false,
            "status": "BOND_STATUS_UNBONDED",
            "tokens": "59638770",
            "delegator_shares": "59638770.000000000000000000",
            "description": {
                "moniker": "Unstake as we will shut down",
                "identity": "C58922A0F158B2D1",
                "website": "https://www.3stakes.com",
                "security_contact": "[email protected]",
                "details": "3Stakes.com is a Dutch team validating in the Ecosystem. Our operations will be CO2 neutral as we will offset any emissions created from our operations. We will be looking to create validators for new chains in the Cosmos ecosystem and participate in testnets."
            },
            "unbonding_height": "10150222",
            "unbonding_time": "2022-05-08T10:37:31.108207984Z",
            "commission": {
                "commission_rates": {
                    "rate": "0.050000000000000000",
                    "max_rate": "0.100000000000000000",
                    "max_change_rate": "0.010000000000000000"
                },
                "update_time": "2022-04-15T08:52:23.793881126Z"
            },
            "min_self_delegation": "1"
        }
    ],
    "pagination": {
        "next_key": "FAIlytQCplRFML0VgJgefml99BfP",
        "total": "0"
    }
}