---
updatedAt: 2025-11-12T01:01:50.000Z
agentTools:
  projectIndex: https://docs.blockberry.one/llms.txt
---

# getValidatorsByAddresses

Get details of multiple validators addresses.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Iota mainnet API",
    "description": "The Iota Blockchain API is used to retrieve Iota Blockchain data. In order to execute queries you need to get API Key and use it in header 'x-api-key'. However, before that you need to sign up on the explorer or company website. If an account is created on the website <strong>https://staketab.com/</strong> or <strong>https://suiscan.xyz/</strong>, the user will be granted the <strong>ROLE_USER</strong> role. After that you may fetch API KEY.",
    "termsOfService": "terms-of-service",
    "contact": {
      "name": "Staketab tech support",
      "url": "https://staketab.com/",
      "email": "support@staketab.com"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.blockberry.one/iota-testnet",
      "description": "Production"
    }
  ],
  "security": [
    {
      "x-api-key": []
    }
  ],
  "paths": {
    "/v1/validators/metadata": {
      "post": {
        "tags": [
          "Accounts"
        ],
        "summary": "getValidatorsByAddresses",
        "description": "Get details of multiple validators addresses.",
        "operationId": "getValidatorsByAddresses",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ValidatorAddressesSearchParams"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "$ref": "#/components/schemas/ValidatorEntity"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ValidatorAddressesSearchParams": {
        "required": [
          "addresses"
        ],
        "type": "object",
        "properties": {
          "addresses": {
            "type": "array",
            "description": "Queried validator address digests (hashes).",
            "example": "0x385db4b24decc41afa78e6f78927ddf89a166b3c6e2a835639f1a8db156da967",
            "items": {
              "type": "string",
              "description": "Queried validator address digests (hashes).",
              "example": "0x385db4b24decc41afa78e6f78927ddf89a166b3c6e2a835639f1a8db156da967"
            }
          }
        }
      },
      "AccountEntity": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string"
          },
          "balance": {
            "type": "number"
          },
          "createTimestamp": {
            "type": "integer",
            "format": "int64"
          },
          "updateTimestamp": {
            "type": "integer",
            "format": "int64"
          },
          "transactions": {
            "type": "integer",
            "format": "int64"
          },
          "img": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "website": {
            "type": "string"
          }
        }
      },
      "SuiNsAccountEntity": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "avatarUrl": {
            "type": "string"
          }
        }
      },
      "SuiensEntity": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "category": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "secondAddress": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "fee": {
            "type": "number"
          },
          "terms": {
            "type": "string"
          },
          "additionalTerms": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "discordNickNames": {
            "type": "string"
          },
          "socialDiscord": {
            "type": "string"
          },
          "socialTelegram": {
            "type": "string"
          },
          "socialTwitter": {
            "type": "string"
          },
          "socialEmail": {
            "type": "string"
          },
          "socialGitHub": {
            "type": "string"
          },
          "validatorVerified": {
            "type": "boolean"
          },
          "image": {
            "type": "string"
          },
          "hide": {
            "type": "boolean"
          }
        }
      },
      "ValidatorEntity": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string"
          },
          "validatorName": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "imageUrl": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "pubkeyBytes": {
            "type": "string"
          },
          "netAddress": {
            "type": "string"
          },
          "networkPubkeyBytes": {
            "type": "string"
          },
          "stakingPoolId": {
            "type": "string"
          },
          "nextEpochStake": {
            "type": "integer",
            "format": "int64"
          },
          "nextEpochCommissionRate": {
            "type": "integer",
            "format": "int64"
          },
          "nextEpochGasPrice": {
            "type": "integer",
            "format": "int64"
          },
          "stakeAmount": {
            "type": "integer",
            "format": "int64"
          },
          "poolTokenBalance": {
            "type": "integer",
            "format": "int64"
          },
          "commissionRate": {
            "type": "integer",
            "format": "int64"
          },
          "gasPrice": {
            "type": "integer",
            "format": "int64"
          },
          "stakingPoolActivationEpoch": {
            "type": "integer",
            "format": "int64"
          },
          "apy": {
            "type": "number"
          },
          "pendingStake": {
            "type": "integer",
            "format": "int64"
          },
          "pendingWithdraw": {
            "type": "string"
          },
          "rewardPool": {
            "type": "integer",
            "format": "int64"
          },
          "slug": {
            "type": "string"
          },
          "metadata": {
            "$ref": "#/components/schemas/ValidatorMetadata"
          },
          "verified": {
            "type": "boolean"
          },
          "committee": {
            "type": "boolean"
          }
        }
      },
      "ValidatorMetadata": {
        "type": "object",
        "properties": {
          "suiensEntity": {
            "$ref": "#/components/schemas/SuiensEntity"
          },
          "validator": {
            "$ref": "#/components/schemas/ValidatorEntity"
          },
          "suiNsAccount": {
            "$ref": "#/components/schemas/SuiNsAccountEntity"
          },
          "account": {
            "$ref": "#/components/schemas/AccountEntity"
          },
          "scamMessage": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "x-api-key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```