> ## Documentation Index
> Fetch the complete documentation index at: https://tonapi.ness.uz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all current validators

> Returns all current validators with stakes, rewards, pool addresses, and (optionally) nominator breakdowns.




## OpenAPI

````yaml GET /v2/rewards/validators
openapi: 3.0.0
info:
  title: REST api to TON blockchain explorer
  version: 2.0.0
  description: Provide access to indexed TON blockchain
  contact:
    name: Support
    email: support@tonkeeper.com
servers:
  - url: https://tonapi.io
  - url: https://testnet.tonapi.io
  - url: http://localhost:8081
security: []
tags:
  - name: Accounts
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/accounts
  - name: Migration
  - name: NFT
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/nft
  - name: Jettons
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/jettons
  - name: DNS
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/dns
  - name: Wallet
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/wallet
  - name: Rates
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/rates
  - name: Staking
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/staking
  - name: Traces
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/traces
  - name: Events
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/events
  - name: Storage
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/storage
  - name: Connect
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/connect
  - name: Gasless
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/gasless
  - name: Multisig
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/multisig
  - name: Blockchain
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/blockchain
  - name: Lite Server
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/lite-server
  - name: Emulation
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/emulation
  - name: Utilities
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/utilities
  - name: ExtraCurrency
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/extra-currency
  - name: Purchases
paths:
  /v2/rewards/validators:
    get:
      tags:
        - Rewards
      summary: Get all current validators
      description: >
        Returns all current validators with stakes, rewards, pool addresses, and
        (optionally) nominator breakdowns.
      operationId: getValidators
      parameters:
        - name: seqno
          in: query
          description: >
            Masterchain block seqno. Defaults to latest. Mutually exclusive with
            `unixtime`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: unixtime
          in: query
          description: >
            Unix timestamp (seconds). Looks up the masterchain block at this
            time and uses it as the anchor. Mutually exclusive with `seqno`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: shallow
          in: query
          description: >
            Set to `1` to return only basic validator info (rank, pubkey,
            effective_stake, weight, reward, pool). Skips pool type detection,
            owner/validator addresses, nominator data, and returned-stake lookup
            — significantly faster.
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidatorsResponse'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    ValidatorsResponse:
      type: object
      required:
        - response_time_ms
        - block
        - validation_round
        - election_id
        - elector_balance
        - total_stake
        - reward_per_block
        - validators
      properties:
        response_time_ms:
          type: integer
          format: int64
          description: Server-side response time in milliseconds.
          example: 12345
        block:
          $ref: '#/components/schemas/BlockInfo'
        validation_round:
          $ref: '#/components/schemas/RoundInfo'
        election_id:
          type: integer
          format: int64
          description: Current election ID (electAt timestamp).
          example: 1740053384
        prev_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately before this one.
          example: 1772486024
        next_election_id:
          type: integer
          format: int64
          description: >
            Election ID of the round immediately after this one. Omitted when
            the current round is not yet finished (next round not known).
          example: 1772658824
        elector_balance:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        reward_per_block:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        validators:
          type: array
          items:
            $ref: '#/components/schemas/ValidatorRewardEntry'
    BlockInfo:
      type: object
      required:
        - seqno
        - time
      properties:
        seqno:
          type: integer
          format: uint32
          description: Masterchain block sequence number.
          example: 57486221
        utime:
          type: integer
          format: int64
          example: 23814011000000
    RoundInfo:
      type: object
      required:
        - start
        - end
        - start_block
        - end_block
      properties:
        start_utime:
          type: integer
          format: int64
          example: 23814011000000
        end_utime:
          type: integer
          format: int64
          example: 23814011000000
        start_block:
          type: integer
          format: uint32
          description: Masterchain block seqno at (or nearest to) validation round start.
          example: 57480000
        end_block:
          type: integer
          format: uint32
          description: Masterchain block seqno at (or nearest to) validation round end.
          example: 57546000
    ValidatorRewardEntry:
      type: object
      required:
        - rank
        - public_key
        - effective_stake
        - weight
        - reward
      properties:
        rank:
          type: integer
          description: Position sorted by effective stake (descending).
          example: 1
        public_key:
          type: string
          description: Validator's public key (hex-encoded Ed25519).
          example: e33f0e53552f951e0a27c8e5a461a1bd65975af369a2c85a06e51f7fbb8ae667
        effective_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        weight:
          type: number
          format: double
          description: Fraction of total effective stake (0–1).
          example: 0.004648
        reward:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        pool:
          type: string
          description: Pool smart contract address (bounceable, base64url).
          example: Ef_bmCmMPsrHKOC4hV8foWBs2TEUAggQ1Wfe6EAqjrI3sGNI
        pool_type:
          type: string
          description: Contract type detected by code hash.
          enum:
            - nominator-pool-v1.0
            - single-nominator-pool-v1.0
            - single-nominator-pool-v1.1
            - other
        owner_address:
          type: string
        validator_address:
          type: string
        validator_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        nominators_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: >
            Total funds deposited by the pool: effective_stake + credit
            (leftover balance kept in the elector contract after election).
          format: int64
          example: 123456789
          x-js-format: bigint
        validator_reward_share:
          type: number
          format: double
          description: Fraction of staking rewards kept by the validator (0.3 = 30%).
          example: 0.3
        nominators_count:
          type: integer
          format: uint32
        nominators:
          type: array
          items:
            $ref: '#/components/schemas/NominatorRewardEntry'
    InsufficientFunds:
      type: object
      description: >
        Present on an error when a request failed because the source wallet does
        not hold enough TON to cover the required gas (error_code 50000).
      required:
        - required
        - available
      properties:
        required:
          type: integer
          format: int64
          description: TON in nanotons required to cover transfer gas
          x-js-format: bigint
        available:
          type: integer
          format: int64
          description: TON in nanotons currently available on the source wallet
          x-js-format: bigint
    NominatorRewardEntry:
      type: object
      required:
        - address
        - weight
        - reward
        - effective_stake
        - stake
      properties:
        address:
          type: string
          description: Nominator's wallet address (bounceable, base64url).
          example: EQAqR4RYauq7p3jqKGnD-eSYVDoOCak9g8ZsSNVHI9fevCzB
        weight:
          type: number
          format: double
          description: Nominator's share of total nominators' deposit (0–1).
          example: 0.15
        reward:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        effective_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
  responses:
    Error:
      description: Some error during request processing
      content:
        application/json:
          schema:
            type: object
            required:
              - error
            properties:
              error:
                type: string
              error_code:
                type: integer
                format: int64
              details:
                $ref: '#/components/schemas/InsufficientFunds'

````

## Related topics

- [Get Staking Pools](/rest/get_staking_pools_get.md)
- [Get Staking Pool Info](/rest/get_staking_pool_info_get.md)
- [Get Blockchain Validators](/rest/get_blockchain_validators_get.md)
- [Get All Auctions](/rest/get_all_auctions_get.md)
- [Get per-validator reward distribution for a finished round](/rest/get_round_rewards_get.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.