Skip to main content

/cosmos/gov/v1beta1/proposals REST API Endpoint

Queries all proposals based on given status.

Updated on
Jul 02, 2025

Parameters

This method does not accept any parameters

Returns

proposals
array

An array of proposals submitted through the governance module

proposal_id
string

The unique identifier assigned to each proposal

content
object

The content object which contains the proposal details

@type
string

The fully qualified type URL of the proposal content (e.g., parameter change, community spend, etc.)

title
string

The title or subject line of the proposal

description
string

A detailed description explaining the purpose and content of the proposal

changes
array

A list of parameter changes proposed in the governance proposal

subspace
string

The module or configuration space that the parameter belongs to (e.g., slashing, icahost)

key
string

The name of the parameter to be updated

value
string

The new value to assign to the parameter (usually encoded as a JSON string, array, or primitive)

recipient
string

The address designated to receive funds (used in community spend proposals)

amount
array

An array representing the amount and denomination of tokens to be distributed

denom
string

The denomination of the token (e.g., utia)

amount
string

The numeric amount of tokens to be transferred

status
string

The current lifecycle status of the proposal (e.g., voting period, passed, rejected)

final_tally_result
object

The final tally result after the voting period ends

yes
string

The total number of 'Yes' votes

abstain
string

The total number of 'Abstain' votes

no
string

The total number of 'No' votes

no_with_veto
string

The total number of 'No with veto' votes

submit_time
string

The timestamp when the proposal was submitted

deposit_end_time
string

The deadline for submitting the required deposit to move the proposal to the voting stage

total_deposit
array

An array containing the denomination and amount of tokens deposited for the proposal

denom
string

The denomination of the deposit (e.g., utia)

amount
string

The total amount of tokens deposited

voting_start_time
string

The timestamp indicating when the voting period begins

voting_end_time
string

The timestamp indicating when the voting period ends

pagination
object

The pagination object which contains details for paginated queries

next_key
string | null

(Optional) The key to be used to retrieve the next page of results; null if there are no more pages

total
string

The total number of results available across all pages

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