Skip to main content

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

Queries votes of a given proposal.

Updated on
May 09, 2024

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 | null

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
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free