Skip to main content

/cosmos/gov/v1beta1/proposals REST API Endpoint

Queries all proposals based on given status.

Updated on
May 15, 2024

/cosmos/gov/v1beta1/proposals REST API Endpoint

Parameters

This method does not accept any parameters

Returns

proposals
array
Defines all the requested governance proposals
proposal_id
string
The unique id of the proposal
content
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type.
type
string
The type of proposal
title
string
The title of the proposal
description
string
The description of the proposal
plan
object
Details of the plan, which contains the following fields:
name
string
The name of the plan
time
string
The scheduled time for the plan
height
string
The block height for the plan
info
string
Additional information about the plan
upgraded_client_state
string
The state of the upgraded client
status
string
Default: `PROPOSAL_STATUS_UNSPECIFIED` Enum: `PROPOSAL_STATUS_UNSPECIFIED` `PROPOSAL_STATUS_DEPOSIT_PERIOD` `PROPOSAL_STATUS_VOTING_PERIOD` `PROPOSAL_STATUS_PASSED` `PROPOSAL_STATUS_REJECTED` `PROPOSAL_STATUS_FAILED status defines the proposal status
final_tally_result
object
final_tally_result is the final tally result of the proposal. When querying a proposal via gRPC, this field is not populated until the proposal's voting period has ended
yes
string
The number of yes votes on a proposal
abstain
string
The number of abstain votes on a proposal
no
string
The number of no votes on a proposal
no_with_veto
string
The number of no with veto votes on a proposal
submit_time
string
The time of proposal submission
deposit_end_time
string
The end time for deposition
total_deposit
array
The total deposit on the proposal
denom
string
The denomination
amount
string
The total deposit amount
voting_start_time
string
The starting time to vote on a proposal
voting_end_time
string
The end time of voting on a proposal
is_expedited
boolean
A boolean flag indicating expedited
pagination
object
Defines the pagination in the response
next_key
string
he 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
The 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'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free