Granite Upgrade Activates in11d:16h:53m:16s
Primary Network

List L1 validators

Lists details for L1 validators. By default, returns details for all active L1 validators. Filterable by validator node ids, subnet id, and validation id.

GET
/v1/networks/{network}/l1Validators
x-glacier-api-key<token>

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://build.avax.network/console/utilities/data-api-keys.

In: header

Path Parameters

networkstring

Either mainnet or testnet/fuji.

Value in"mainnet" | "fuji" | "testnet"

Query Parameters

pageToken?string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize?integer

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Default10
Range1 <= value <= 100
l1ValidationId?string

The L1 Validator's validation ID to filter by. If not provided, then all L1 Validators will be returned.

includeInactiveL1Validators?boolean
nodeId?string

A valid node ID in format 'NodeID-HASH'.

subnetId?unknown

The subnet ID to filter by. If not provided, then all subnets will be returned.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://data-api.avax.network/v1/networks/mainnet/l1Validators?pageSize=10&l1ValidationId=BsSpTd1SDvdhaoYAuKJvRj1WnoRyu8mAuMZeuz9g7brGj6KhX&nodeId=NodeID-111111111111111111116DBWJs&subnetId=11111111111111111111111111111111LpoYY"
{
  "nextPageToken": "string",
  "validators": [
    {
      "validationId": "string",
      "validationIdHex": "string",
      "nodeId": "string",
      "subnetId": "string",
      "weight": 0,
      "remainingBalance": 0,
      "creationTimestamp": 0,
      "blsCredentials": {},
      "remainingBalanceOwner": {
        "addresses": [
          "string"
        ],
        "threshold": 0
      },
      "deactivationOwner": {
        "addresses": [
          "string"
        ],
        "threshold": 0
      }
    }
  ],
  "blockHeight": "string"
}
{
  "message": "string",
  "statusCode": 400,
  "error": "Bad Request"
}
{
  "message": "string",
  "statusCode": 401,
  "error": "Unauthorized"
}
{
  "message": "string",
  "statusCode": 403,
  "error": "Forbidden"
}
{
  "message": "string",
  "statusCode": 404,
  "error": "Not Found"
}
{
  "message": "string",
  "statusCode": 429,
  "error": "Too Many Requests"
}
{
  "message": "string",
  "statusCode": 500,
  "error": "Internal Server Error"
}
{
  "message": "string",
  "statusCode": 502,
  "error": "Bad Gateway"
}
{
  "message": "string",
  "statusCode": 503,
  "error": "Service Unavailable"
}

Is this guide helpful?