---
title: "Votes queries votes of a given proposal."
method: GET
path: "/cosmos/gov/v1beta1/proposals/{proposalId}/votes"
tags: ["Query"]
---

# Votes queries votes of a given proposal.

`GET /cosmos/gov/v1beta1/proposals/{proposalId}/votes`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/notional-labs/apis/http-api-console/docs/cosmos/gov/v1beta1/proposals/:proposalId/votes/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `proposalId` string, uint64, required

## Query parameters

- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.countTotal` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- object: QueryVotesResponse is the response type for the Query/Votes RPC method.
  - `votes` object[]: votes defined the queried votes.
    - `proposalId` string, uint64
    - `voter` string
    - `option` 'VOTE_OPTION_UNSPECIFIED' | 'VOTE_OPTION_YES' | 'VOTE_OPTION_ABSTAIN' | 'VOTE_OPTION_NO' | 'VOTE_OPTION_NO_WITH_VETO': Deprecated: Prefer to use `options` instead. This field is set in queries if and only if `len(options) == 1` and that option has weight 1. In all other cases, this field will default to VOTE_OPTION_UNSPECIFIED.
    - `options` object[]
      - `option` 'VOTE_OPTION_UNSPECIFIED' | 'VOTE_OPTION_YES' | 'VOTE_OPTION_ABSTAIN' | 'VOTE_OPTION_NO' | 'VOTE_OPTION_NO_WITH_VETO': VoteOption enumerates the valid vote options for a given governance proposal. - VOTE_OPTION_UNSPECIFIED: VOTE_OPTION_UNSPECIFIED defines a no-op vote option. - VOTE_OPTION_YES: VOTE_OPTION_YES defines a yes vote option. - VOTE_OPTION_ABSTAIN: VOTE_OPTION_ABSTAIN defines an abstain vote option. - VOTE_OPTION_NO: VOTE_OPTION_NO defines a no vote option. - VOTE_OPTION_NO_WITH_VETO: VOTE_OPTION_NO_WITH_VETO defines a no with veto vote option.
      - `weight` string
  - `pagination` object: pagination defines the pagination in the response.
    - `nextKey` string, byte
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

## Changes

- **2021-09-03** `4165dbef2a32`: 1 info
  - added the new optional `query` request parameter `pagination.reverse`
- **2021-08-25** `c8a66a59aefb`: 1 warning
  - deleted the `query` request parameter `pagination.reverse`
- **2021-08-05** `4165dbef2a32`: 1 info
  - added the new optional `query` request parameter `pagination.reverse`
- **2021-06-05** `7528569a81ca`: 1 warning
  - deleted the `query` request parameter `pagination.reverse`

[Operation history](https://skmtc.dev/notional-labs/apis/http-api-console/changes/cosmos/gov/v1beta1/proposals/:proposalId/votes/get.md)

---

[API](https://skmtc.dev/notional-labs/apis/http-api-console.md) - [All operations](https://skmtc.dev/notional-labs/apis/http-api-console/llms.txt) - [OpenAPI document](https://skmtc.dev/notional-labs/apis/http-api-console/revisions/b52b697c5776?raw)