---
updatedAt: 2026-05-07T01:57:09.000Z
agentTools:
  projectIndex: https://docs.mavan.bitminetech.io/llms.txt
---

# Get Validators

Returns Validators for your account with filtering on reference, withdrawal address, and status. Records are returned in order of initial request.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/ethereum/orderedValidators": {
      "get": {
        "description": "Returns Validators for your account with filtering on reference, withdrawal address, and status. Records are returned in order of initial request.",
        "operationId": "getEthereumOrderedValidators",
        "parameters": [
          {
            "name": "reference",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "withdrawalAddress",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "count",
            "required": false,
            "in": "query",
            "description": "defaults to 100",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "skip",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "api-key",
            "in": "header",
            "description": "mavan api key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ApiResponseBase"
                    },
                    {
                      "properties": {
                        "data": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/ValidatorWithStakeDetails"
                          }
                        }
                      }
                    }
                  ],
                  "required": [
                    "data"
                  ]
                }
              }
            }
          }
        },
        "summary": "Get Validators",
        "tags": [
          "Ethereum"
        ]
      }
    }
  },
  "info": {
    "title": "MAVAN Staking API",
    "description": "The MAVAN Staking API Docs",
    "version": "1.0.181-main-mainnet",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://gw-1.api.standardvalidator.com"
    }
  ],
  "components": {
    "schemas": {
      "ApiResponseBase": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          }
        }
      },
      "ValidatorDeposit": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "number"
          },
          "slot": {
            "type": "number"
          },
          "status": {
            "type": "string",
            "enum": [
              "QUEUED",
              "PROCESSED"
            ]
          }
        },
        "required": [
          "amount",
          "slot",
          "status"
        ]
      },
      "ValidatorWithdrawal": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "number"
          },
          "withdrawableEpoch": {
            "type": "number"
          },
          "status": {
            "type": "string",
            "enum": [
              "QUEUED",
              "PROCESSED"
            ]
          }
        },
        "required": [
          "amount",
          "withdrawableEpoch",
          "status"
        ]
      },
      "ValidatorConsolidation": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "number"
          },
          "targetPubkey": {
            "type": "string"
          },
          "sourcePubkey": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "QUEUED",
              "PROCESSED"
            ]
          }
        },
        "required": [
          "amount",
          "targetPubkey",
          "sourcePubkey",
          "status"
        ]
      },
      "PendingIncoming": {
        "type": "object",
        "properties": {
          "activeCount": {
            "type": "number",
            "description": "Number of active consolidations targeting this validator"
          },
          "totalIncomingGwei": {
            "type": "string",
            "description": "Total incoming amount in Gwei from pending consolidations"
          }
        },
        "required": [
          "activeCount",
          "totalIncomingGwei"
        ]
      },
      "ValidatorWithStakeDetails": {
        "type": "object",
        "properties": {
          "pubkey": {
            "type": "string"
          },
          "vmId": {
            "type": "number",
            "description": "Validator VM ID"
          },
          "withdrawal_credentials": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "signature": {
            "type": "string"
          },
          "deposit_message_root": {
            "type": "string"
          },
          "region": {
            "type": "string",
            "enum": [
              "US",
              "EU",
              "AU"
            ]
          },
          "deposit_data_root": {
            "type": "string"
          },
          "fork_version": {
            "type": "string"
          },
          "network_name": {
            "type": "string"
          },
          "deposit_cli_version": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "suggestedFeeRecipient": {
            "type": "string"
          },
          "validatorIndex": {
            "type": "number"
          },
          "statusLastChecked": {
            "type": "string"
          },
          "balanceGwei": {
            "type": "string"
          },
          "effectiveBalanceGwei": {
            "type": "string"
          },
          "activatedAt": {
            "type": "number",
            "description": "Unix timestamp in seconds when validator became active"
          },
          "exitedAt": {
            "type": "number",
            "description": "Unix timestamp in seconds when validator exited"
          },
          "withdrawableAt": {
            "type": "number",
            "description": "Unix timestamp in seconds when validator balance becomes withdrawable"
          },
          "stakeOid": {
            "type": "string",
            "description": "Stake Object ID from database"
          },
          "stakeId": {
            "type": "number",
            "description": "Stake ID"
          },
          "withdrawalAddress": {
            "type": "string",
            "description": "Withdrawal address for the validator"
          },
          "deposits": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidatorDeposit"
            }
          },
          "withdrawals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidatorWithdrawal"
            }
          },
          "consolidations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidatorConsolidation"
            }
          },
          "activationEpoch": {
            "type": "number",
            "description": "Epoch when validator became active"
          },
          "activationEligibilityEpoch": {
            "type": "number",
            "description": "Epoch when sum of validator deposits reached the minimum activation balance"
          },
          "exitEpoch": {
            "type": "number",
            "description": "Epoch when validator was exited"
          },
          "withdrawableEpoch": {
            "type": "number",
            "description": "Epoch when validator balance became withdrawable after exit"
          },
          "pendingIncoming": {
            "description": "Pending incoming consolidation amounts for this validator",
            "allOf": [
              {
                "$ref": "#/components/schemas/PendingIncoming"
              }
            ]
          },
          "reference": {
            "type": "string"
          },
          "label": {
            "type": "string"
          }
        },
        "required": [
          "pubkey",
          "withdrawal_credentials",
          "amount",
          "signature",
          "deposit_message_root",
          "deposit_data_root",
          "fork_version",
          "network_name",
          "deposit_cli_version",
          "status",
          "suggestedFeeRecipient",
          "validatorIndex",
          "statusLastChecked",
          "balanceGwei",
          "effectiveBalanceGwei",
          "reference",
          "label"
        ]
      }
    }
  }
}
```