---
title: "Get period voters"
method: GET
path: "/v1/voting/periods/{index}/voters"
tags: ["Voting"]
---

# Get period voters

`GET /v1/voting/periods/{index}/voters`

## Request

- Base URL: `https://api.tzkt.io`
- URL: `https://api.tzkt.io/v1/voting/periods/{index}/voters`
- Auth: none declared

Returns voters from the voting period at the specified index.

## Path parameters

- `index` integer, required

## Query parameters

- `status` VoterStatusParameter
  - `eq` string, nullable: **Equal** filter mode (optional, i.e. `param.eq=123` is the same as `param=123`). \ Specify a voter status to get items where the specified field is equal to the specified value. Example: `?status=none`.
  - `ne` string, nullable: **Not equal** filter mode. \ Specify a voter status to get items where the specified field is not equal to the specified value. Example: `?status.ne=none`.
  - `in` string[], nullable: **In list** (any of) filter mode. \ Specify a comma-separated list of voter statuses to get items where the specified field is equal to one of the specified values. Example: `?status.in=voted_yay,voted_nay`.
  - `ni` string[], nullable: **Not in list** (none of) filter mode. \ Specify a comma-separated list of voter statuses to get items where the specified field is not equal to all the specified values. Example: `?status.ni=none,upvoted`.
- `sort` SortParameter
  - `asc` string, nullable: **Ascending** sort mode (optional, i.e. `sort.asc=id` is the same as `sort=id`). \ Specify a field name to sort by. Example: `?sort=balance`.
  - `desc` string, nullable: **Descending** sort mode. \ Specify a field name to sort by descending. Example: `?sort.desc=id`.
- `offset` OffsetParameter
  - `el` integer, nullable: **Elements** offset mode (optional, i.e. `offset.el=123` is the same as `offset=123`). \ Skips specified number of elements. Example: `?offset=100`.
  - `pg` integer, nullable: **Page** offset mode. \ Skips `page * limit` elements. This is a classic pagination. Example: `?offset.pg=1`.
  - `cr` integer, nullable: **Cursor** offset mode. \ Skips all elements with the `cursor` before (including) the specified value. Cursor is a field used for sorting, e.g. `id`. Avoid using this offset mode with non-unique or non-sequential cursors such as `amount`, `balance`, etc. Example: `?offset.cr=45837`.
- `limit` integer

## Response `200`

- VoterSnapshot[]
  - `delegate` Alias, required
    - `alias` string, nullable: Account alias name (off-chain data).
    - `address` string, required: Account address (public key hash).
  - `votingPower` integer: Baker's voting power
  - `status` string, required: Voter's status: `none` - the voter did nothing `upvoted` - the voter upvoted at least one proposal `voted_yay` - the voter voted "yay" `voted_nay` - the voter voted "nay" `voted_pass` - the voter voted "pass"

---

[API](https://skmtc.dev/tzkt/apis/tzkt-api.md) - [All operations](https://skmtc.dev/tzkt/apis/tzkt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tzkt/apis/tzkt-api/revisions/a2e2aba5e534?raw)