---
title: "VotesByProposal queries a vote by proposal id."
method: GET
path: "/cosmos/group/v1/votes_by_proposal/{proposal_id}"
tags: ["Query"]
---

# VotesByProposal queries a vote by proposal id.

`GET /cosmos/group/v1/votes_by_proposal/{proposal_id}`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `proposal_id` string, uint64, required

## Query parameters

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

## Response `200`

A successful response.

- object: QueryVotesByProposalResponse is the Query/VotesByProposal response type.
  - `votes` object[]: votes are the list of votes for given proposal_id.
    - `proposal_id` string, uint64: proposal is the unique ID of the proposal.
    - `voter` string: voter is the account address of the voter.
    - `option` 'VOTE_OPTION_UNSPECIFIED' | 'VOTE_OPTION_YES' | 'VOTE_OPTION_ABSTAIN' | 'VOTE_OPTION_NO' | 'VOTE_OPTION_NO_WITH_VETO': option is the voter's choice on the proposal.
    - `metadata` string
    - `submit_time` string, date-time: submit_time is the timestamp when the vote was submitted.
  - `pagination` object: pagination defines the pagination in the response.
    - `next_key` string, byte: next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-01-28** `7ee619f48b09`: 1 info
  - endpoint added
- **2024-03-22** `f6ed714cd62d`: 1 breaking
  - api path removed without deprecation
- **2024-03-22** `426ef0503938`: 1 info
  - endpoint added
- **2024-02-21** `9da39c06448a`: 1 breaking
  - api path removed without deprecation
- **2024-02-07** `0345868c59cf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/changes/cosmos/group/v1/votes_by_proposal/:proposal_id/get.md)

---

[API](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/revisions/52aa42be34ad?raw)