> ## 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 validation round metadata

> Returns past and current validation rounds with boundaries, stakes, and bonuses. Always uses the latest masterchain block.




## OpenAPI

````yaml GET /v2/rewards/validation-rounds
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/validation-rounds:
    get:
      tags:
        - Rewards
      summary: Get validation round metadata
      description: >
        Returns past and current validation rounds with boundaries, stakes, and
        bonuses. Always uses the latest masterchain block.
      operationId: getValidationRounds
      parameters:
        - name: election_id
          in: query
          description: >
            Return the single round matching this election ID. Mutually
            exclusive with `block` and `unixtime`.
          required: false
          schema:
            type: integer
            format: int64
        - name: block
          in: query
          description: >
            Find the round containing this masterchain block seqno and return it
            plus up to `limit-1` older rounds. Mutually exclusive with
            `election_id` and `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
            `election_id` and `block`.
          required: false
          schema:
            type: integer
            format: uint32
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationRoundsResponse'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    ValidationRoundsResponse:
      type: object
      required:
        - response_time_ms
        - rounds
      properties:
        response_time_ms:
          type: integer
          format: int64
          description: Server-side response time in milliseconds.
          example: 1234
        rounds:
          type: array
          items:
            $ref: '#/components/schemas/ValidationRound'
    ValidationRound:
      type: object
      required:
        - election_id
        - start
        - end
        - start_block
        - finished
      properties:
        election_id:
          type: integer
          format: int64
          description: Election ID (electAt timestamp).
          example: 1740053384
        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) round start.
          example: 57480000
        end_block:
          type: integer
          format: uint32
          description: >-
            Masterchain block seqno at (or nearest to) round end. Omitted if
            round hasn't finished.
          example: 57546000
        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
            this round is not yet finished (next round not known).
          example: 1772658824
        total_stake:
          type: integer
          description: Total stake locked in the round.
          format: int64
          example: 123456789
          x-js-format: bigint
        bonuses:
          type: integer
          description: >-
            Total rewards the elector pays for the round. Omitted if round
            hasn't finished.
          format: int64
          example: 123456789
          x-js-format: bigint
        finished:
          type: boolean
          description: Whether the validation round is complete.
          example: true
    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
  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 per-validator reward distribution for a finished round](/rest/get_round_rewards_get.md)
- [Get all current validators](/rest/get_validators_get.md)
- [Get historical APY and stake statistics](/rest/get_rewards_stats_get.md)
- [Get current TON blockchain APY](/rest/get_rewards_apy_get.md)
- [Overview](/rest/overview.md)


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