Epochs

Get voting epochs

get

Returns a list of voting epochs.

Query parameters

sortone of | nullableOptional

Sorts voting epochs by specified field. Supported fields: id (default).

offsetone of | nullableOptional

Specifies which or how many items should be skipped

limitinteger · int32 · max: 10000Optional

Maximum number of items to return

Default: 100

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /v1/voting/epochs HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "index": 1,
    "firstLevel": 1,
    "startTime": "2025-07-14T05:30:10.339Z",
    "lastLevel": 1,
    "endTime": "2025-07-14T05:30:10.339Z",
    "status": "text",
    "periods": [
      {
        "index": 1,
        "epoch": 1,
        "firstLevel": 1,
        "startTime": "2025-07-14T05:30:10.339Z",
        "lastLevel": 1,
        "endTime": "2025-07-14T05:30:10.339Z",
        "kind": "text",
        "status": "text",
        "dictator": "text",
        "totalBakers": 1,
        "totalVotingPower": 1,
        "upvotesQuorum": 1,
        "proposalsCount": 1,
        "topUpvotes": 1,
        "topVotingPower": 1,
        "ballotsQuorum": 1,
        "supermajority": 1,
        "yayBallots": 1,
        "yayVotingPower": 1,
        "nayBallots": 1,
        "nayVotingPower": 1,
        "passBallots": 1,
        "passVotingPower": 1,
        "totalRolls": 1,
        "topRolls": 1,
        "yayRolls": 1,
        "nayRolls": 1,
        "passRolls": 1
      }
    ],
    "proposals": [
      {
        "hash": "text",
        "initiator": {
          "alias": "text",
          "address": "text"
        },
        "firstPeriod": 1,
        "lastPeriod": 1,
        "epoch": 1,
        "upvotes": 1,
        "votingPower": 1,
        "status": "text",
        "extras": null,
        "rolls": 1,
        "metadata": null
      }
    ]
  }
]

Get voting epoch by index

get

Returns a voting epoch at the specified index.

Path parameters

indexinteger · int32Required

Voting epoch index starting from zero

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /v1/voting/epochs/{index} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

{
  "index": 1,
  "firstLevel": 1,
  "startTime": "2025-07-14T05:30:10.339Z",
  "lastLevel": 1,
  "endTime": "2025-07-14T05:30:10.339Z",
  "status": "text",
  "periods": [
    {
      "index": 1,
      "epoch": 1,
      "firstLevel": 1,
      "startTime": "2025-07-14T05:30:10.339Z",
      "lastLevel": 1,
      "endTime": "2025-07-14T05:30:10.339Z",
      "kind": "text",
      "status": "text",
      "dictator": "text",
      "totalBakers": 1,
      "totalVotingPower": 1,
      "upvotesQuorum": 1,
      "proposalsCount": 1,
      "topUpvotes": 1,
      "topVotingPower": 1,
      "ballotsQuorum": 1,
      "supermajority": 1,
      "yayBallots": 1,
      "yayVotingPower": 1,
      "nayBallots": 1,
      "nayVotingPower": 1,
      "passBallots": 1,
      "passVotingPower": 1,
      "totalRolls": 1,
      "topRolls": 1,
      "yayRolls": 1,
      "nayRolls": 1,
      "passRolls": 1
    }
  ],
  "proposals": [
    {
      "hash": "text",
      "initiator": {
        "alias": "text",
        "address": "text"
      },
      "firstPeriod": 1,
      "lastPeriod": 1,
      "epoch": 1,
      "upvotes": 1,
      "votingPower": 1,
      "status": "text",
      "extras": null,
      "rolls": 1,
      "metadata": null
    }
  ]
}