# Get validators

Get a paginated list of validators

```
GET /validators
```

## Query params

| Query param  | Description                                                                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `era_id`     | Active auction era identifier. Data for older eras aren't persistent for long, and will eventually become unavailable. This is a required parameter |
| `is_active`  | Validator active filter param                                                                                                                       |
| `public_key` | Comma-separated list of public key                                                                                                                  |

## Sorting

| Property            | Description                          |
| ------------------- | ------------------------------------ |
| `rank`              | Sort validators by rank              |
| `fee`               | Sort validators by fee               |
| `delegators_number` | Sort validators by delegators number |
| `total_stake`       | Sort validators by total stake       |
| `self_stake`        | Sort validators by self stake        |
| `network_share`     | Sort validators by network share     |

Default sorting is `total_stake DESC`

## Optional properties

| Property                   | Type                                                                                        | Description                                                                                             |
| -------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `account_info`             | [`AccountInfo`](https://docs.cspr.cloud/1.4.x/rest-api/account-info)                        | [Account info](https://github.com/make-software/casper-account-info-contract) provided by the validator |
| `centralized_account_info` | [`CentralizedAccountInfo`](https://docs.cspr.cloud/1.4.x/rest-api/centralized-account-info) | Account information available for known accounts provided by CSPR.cloud team                            |
| `cspr_name`                | `string`                                                                                    | Primary CSPR.name of the validator account                                                              |
| `average_performance`      | [`ValidatorPerformance`](https://docs.cspr.cloud/1.4.x/rest-api/validator-performance)      | Validator average performance                                                                           |

## Response

[`PaginatedResponse`](https://docs.cspr.cloud/1.4.x/documentation/overview/pagination)[`<Validator>`](https://docs.cspr.cloud/1.4.x/rest-api/validator)

## Example

{% hint style="info" %}
Since this API works only with recent eras, you'll need to replace the era ID with the latest one, which you can fetch using the [Get auction metrics API](https://docs.cspr.cloud/1.4.x/rest-api/auction-metrics/get-auction-metrics).
{% endhint %}

```bash
curl -X 'GET' \
  'https://api.testnet.cspr.cloud/validators?era_id=12100' \
  -H 'accept: application/json' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'

```

```json
{
  "item_count": 100,
  "page_count": 10,
  "data": [
    {
      "delegators_number": 327,
      "delegators_stake": 514860723339425900,
      "era_id": 12099,
      "fee": 15,
      "is_active": true,
      "network_share": "6.16",
      "public_key": "018f84c6fc037284f189cc8cb49f89212ff434a5eb050e48cdd164ff3890fbff69",
      "rank": 1,
      "self_share": "0.3",
      "self_stake": 1524223078827207,
      "total_stake": 516384946418253100
    },
    {
      "delegators_number": 537,
      "delegators_stake": 316963498155044600,
      "era_id": 12099,
      "fee": 10,
      "is_active": true,
      "network_share": "3.78",
      "public_key": "01bf489970ee9ad639854b9a78ed19d08b5f8d8f2185099b44c0fc5f6f467b14b4",
      "rank": 2,
      "self_share": "0",
      "self_stake": 1756858998778,
      "total_stake": 316965255014043400
    },
    ...
    {
      "delegators_number": 122,
      "delegators_stake": 206573767985058270,
      "era_id": 12099,
      "fee": 10,
      "is_active": true,
      "network_share": "2.47",
      "public_key": "015fd964620f98e551065079e142840dac3fb25bd97a0d4722411cb439f9247d72",
      "rank": 10,
      "self_share": "0.2",
      "self_stake": 405441796728029,
      "total_stake": 206979209781786300
    }
  ]
}
```