Skip to main content

/cosmos/gov/v1beta1/proposals REST API Endpoint

Queries all proposals based on given status.

Updated on
May 09, 2024

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 protobuf type URL of the proposal content

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

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

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