Skip to main content

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

Queries a proposal based on proposal id.

Updated on
May 09, 2024

Path Parameters

proposal_id
string
REQUIRED

The unique ID of a proposal.

Returns

proposal
object

The requested governance proposal

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

The state of the upgraded client

is_expedited
boolean

Whether the proposal is expedited

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

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free