---
title: "Returns a list of governance proposals."
method: GET
path: "/consensus/proposals"
---

# Returns a list of governance proposals.

`GET /consensus/proposals`

## Query parameters

- `limit` integer
- `offset` integer
- `submitter` string — An Oasis-style (bech32) address.
- `state` 'active' | 'passed' | 'failed' | 'rejected' — The state of the proposal.

## Response `200`

A JSON object containing a list of governance proposals.

- ProposalList — A list of governance proposals.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `proposals` Proposal[], required
    - `id` integer, required — The unique identifier of the proposal.
    - `submitter` string, required — The staking address of the proposal submitter.
    - `state` 'active' | 'passed' | 'failed' | 'rejected', required — The state of the proposal.
    - `deposit` string, bigint, required
    - `title` string — The (optional) title of the proposal.
    - `description` string — The (optional) description of the proposal.
    - `handler` string — The name of the upgrade handler.
    - `target` ProposalTarget — The target protocol versions for this upgrade proposal.
      - `consensus_protocol` string
      - `runtime_host_protocol` string
      - `runtime_committee_protocol` string
    - `epoch` integer — The epoch at which the proposed upgrade will happen.
    - `cancels` integer — The proposal to cancel, if this proposal proposes cancelling an existing proposal.
    - `parameters_change_module` string — The name of the module whose parameters are to be changed by this 'parameters_change' proposal.
    - `parameters_change` string — The parameters change proposal body. This spec does not encode the many possible types; instead, see [the Go API](https://pkg.go.dev/github.com/oasisprotocol/oasis-core/go) of oasis-core. This object will conform to one of the `ConsensusParameterChanges` types, depending on the `parameters_change_module`.
    - `created_at` integer, required — The epoch at which this proposal was created.
    - `closes_at` integer, required — The epoch at which voting for this proposal will close.
    - `invalid_votes` string, bigint, required

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)