Skip to main content

/cosmos/gov/v1beta1/proposals/{proposal_id}/votes REST API Endpoint

Queries votes of a given proposal.

Updated on
May 15, 2024

/cosmos/gov/v1beta1/proposals/{proposal_id}/votes REST API Endpoint

Path Parameters

proposal_id
string
REQUIRED
The unique ID of a proposal

Query Parameters

pagination.key
string <byte>
Key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set
pagination.offset
string <uint64>
Offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set
pagination.limit
string <uint64>
The total number of results to be returned in the result page. If left empty it will default to a value to be set by each app
pagination.count_total
boolean
Set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set
pagination.reverse
boolean
Reverse is set to true if results are to be returned in the descending order. Since: cosmos-sdk 0.43

Returns

votes
array
Defines the queried votes
proposal_id
string
Defines the unique id of the proposal
voter
string
The voter address of the proposal
option
string
Default: `VOTE_OPTION_UNSPECIFIED` Enum: `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
array
The weighted vote options.Since: cosmos-sdk 0.43
option
string
Defines the valid vote options, it must not contain duplicate vote options. Default: `VOTE_OPTION_UNSPECIFIED` Enum: `VOTE_OPTION_UNSPECIFIED` `VOTE_OPTION_YES` `VOTE_OPTION_ABSTAIN` `VOTE_OPTION_NO` `VOTE_OPTION_NO_WITH_VETO`
weight
string
The vote weight associated with the vote option
pagination
object
The pagination object which contains the following fields:
next_key
string
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
string <uint64> (total is total number of results available if PageRequest.count_total was set, its value is undefined otherwise)
Request
1
curl --location 'https://docs-demo.cosmos-mainnet.quiknode.pro/cosmos/gov/v1beta1/proposals/920/votes'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free