---
title: "Get a list of governance proposals"
method: GET
path: "/api/v1/gov/proposal"
---

# Get a list of governance proposals

`GET /api/v1/gov/proposal`

## Query parameters

- `page` integer
- `status` 'pending' | 'votingPeriod' | 'passed' | 'rejected' | 'executedPassed' | 'executedRejected'
- `kind` 'default' | 'defaultWithWasm' | 'pgfSteward' | 'pgfFunding'
- `pattern` string

## Response `200`

A list of governance proposal.

- object
  - `results` Proposal[], required
    - `id` string, required
    - `content` string, required
    - `type` 'default' | 'defaultWithWasm' | 'pgfSteward' | 'pgfFunding', required
    - `tallyType` 'twoFifths' | 'oneHalfOverOneThird' | 'lessOneHalfOverOneThirdNay', required
    - `data` string
    - `author` string, required
    - `startEpoch` string, required
    - `endEpoch` string, required
    - `activationEpoch` string, required
    - `startTime` string, required
    - `endTime` string, required
    - `currentTime` string, required
    - `activationTime` string, required
    - `status` 'pending' | 'voting' | 'passed' | 'rejected' | 'executedPassed' | 'ExecutedRejected', required
    - `yayVotes` string, required
    - `nayVotes` string, required
    - `abstainVotes` string, required
  - `pagination` Pagination, required
    - `page` string
    - `perPage` string
    - `totalPages` string
    - `totalItems` string

## Changes

- **2025-03-12** `a403736c0dcf` — 2 info
  - added the new enum value `executedPassed` to the `query` request parameter `status`
  - added the new enum value `executedRejected` to the `query` request parameter `status`
- **2025-03-12** `ed02f7f2ea60` — 2 warning
  - added the new `ExecutedRejected` enum value to the `results/items/status` response property for the response status `200`
  - added the new `executedPassed` enum value to the `results/items/status` response property for the response status `200`
- **2024-12-17** `6893b0238070` — 9 breaking, 2 info
  - removed the enum value `executedPassed` from the `query` request parameter `status`
  - removed the enum value `executedRejected` from the `query` request parameter `status`
  - the `results/items/abstainVotes` response's property type changed from `number` to `string`, and format from `float` to no format for status `200`
  - the `results/items/activationEpoch` response's property type changed from `number` to `string` for status `200`
  - …7 more

[Change history](https://skmtc.dev/namada-net/apis/namada-interface-indexer-rest-api/changes/api/v1/gov/proposal/get.md)

---

[API](https://skmtc.dev/namada-net/apis/namada-interface-indexer-rest-api.md) · [All operations](https://skmtc.dev/namada-net/apis/namada-interface-indexer-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namada-net/apis/namada-interface-indexer-rest-api/revisions/a403736c0dcf?raw)