---
title: "Proposals queries all proposals based on given status."
method: GET
path: "/cosmos/gov/v1beta1/proposals"
tags: ["Query"]
---

# Proposals queries all proposals based on given status.

`GET /cosmos/gov/v1beta1/proposals`

## Query parameters

- `proposal_status` 'PROPOSAL_STATUS_UNSPECIFIED' | 'PROPOSAL_STATUS_DEPOSIT_PERIOD' | 'PROPOSAL_STATUS_VOTING_PERIOD' | 'PROPOSAL_STATUS_PASSED' | 'PROPOSAL_STATUS_REJECTED' | 'PROPOSAL_STATUS_FAILED'
- `voter` string
- `depositor` string
- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- CosmosGovV1beta1QueryProposalsResponse — QueryProposalsResponse is the response type for the Query/Proposals RPC method.
  - `pagination` CosmosBaseQueryV1beta1PageResponse — PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte — next_key is the 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, uint64
  - `proposals` CosmosGovV1beta1Proposal[] — proposals defines all the requested governance proposals.
    - `content` GoogleProtobufAny
      - `@type` string
    - `deposit_end_time` string, date-time — deposit_end_time is the end time for deposition.
    - `final_tally_result` CosmosGovV1beta1TallyResult — TallyResult defines a standard tally for a governance proposal.
      - `abstain` string — abstain is the number of abstain votes on a proposal.
      - `no` string — no is the number of no votes on a proposal.
      - `no_with_veto` string — no_with_veto is the number of no with veto votes on a proposal.
      - `yes` string — yes is the number of yes votes on a proposal.
    - `proposal_id` string, uint64 — proposal_id defines the unique id of the proposal.
    - `status` 'PROPOSAL_STATUS_UNSPECIFIED' | 'PROPOSAL_STATUS_DEPOSIT_PERIOD' | 'PROPOSAL_STATUS_VOTING_PERIOD' | 'PROPOSAL_STATUS_PASSED' | 'PROPOSAL_STATUS_REJECTED' | 'PROPOSAL_STATUS_FAILED' — ProposalStatus enumerates the valid statuses of a proposal. - PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status. - PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period. - PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period. - PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed. - PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected. - PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.
    - `submit_time` string, date-time — submit_time is the time of proposal submission.
    - `total_deposit` CosmosBaseV1beta1Coin[] — total_deposit is the total deposit on the proposal.
      - `amount` string
      - `denom` string
    - `voting_end_time` string, date-time — voting_end_time is the end time of voting on a proposal.
    - `voting_start_time` string, date-time — voting_start_time is the starting time to vote on a proposal.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2025-05-26** `671fab54b729` — 1 info
  - api operation id `EvidenceQuery_ProposalsMixin112` removed and replaced with `EvidenceQuery_ProposalsMixin119`
- **2025-05-21** `3874a03b0e7b` — 1 info
  - api operation id `UpgradeQuery_ProposalsMixin112` removed and replaced with `EvidenceQuery_ProposalsMixin112`
- **2025-05-09** `8dbfaa2bebb2` — 1 info
  - api operation id `CircuitQuery_ProposalsMixin112` removed and replaced with `UpgradeQuery_ProposalsMixin112`
- **2025-04-08** `21a675703a05` — 1 info
  - api operation id `AuthQuery_ProposalsMixin112` removed and replaced with `CircuitQuery_ProposalsMixin112`
- **2025-03-27** `4f349536c8f3` — 1 info
  - api operation id `FeegrantQuery_ProposalsMixin111` removed and replaced with `AuthQuery_ProposalsMixin112`

[Full history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos/gov/v1beta1/proposals/get.md)

---

[API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc.dev/pokt-network/apis/http-api-console/revisions/671fab54b729?raw)