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

Path Parameters

proposal_id

string

REQUIRED

The unique ID of a proposal.

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

Request

curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/gov/v1beta1/proposals/3'

package main

import (
	"context"
	gov "cosmossdk.io/api/cosmos/gov/v1beta1"
	"fmt"
	"google.golang.org/grpc"
	"log"
)

func main() {
	endpoint := "YOUR_QUICKNODE_ENDPOINT"
	target, opts := getGrpcOptions(endpoint)
	grpcConn, err := grpc.Dial(target, opts...)
	if err != nil {
		log.Fatal(err)
	}
	defer grpcConn.Close()

	governance := gov.NewQueryClient(grpcConn)
	resp, err := governance.Proposal(context.Background(), &gov.QueryProposalRequest{ProposalId: 3})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(resp.GetProposal().GetProposalId(), resp.GetProposal().GetStatus())
}

const myHeaders = new Headers();
myHeaders.append("Accept", "*/*");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/gov/v1beta1/proposals/3", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

import requests

url = "https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/gov/v1beta1/proposals/3"

payload = {}
headers = {
  'Accept': '*/*'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "net/http"

url = URI("https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/gov/v1beta1/proposals/3")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Accept"] = "*/*"

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free