---
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` number, required
    - `content` string, required
    - `type` 'default' | 'defaultWithWasm' | 'pgfSteward' | 'pgfFunding', required
    - `tallyType` 'twoFifths' | 'oneHalfOverOneThird' | 'lessOneHalfOverOneThirdNay', required
    - `data` string
    - `author` string, required
    - `startEpoch` number, required
    - `endEpoch` number, required
    - `activationEpoch` number, required
    - `startTime` string, required
    - `endTime` string, required
    - `currentTime` string, required
    - `activationTime` string, required
    - `status` 'pending' | 'voting' | 'passed' | 'rejected' | 'executedPassed' | 'executedRejected', required
    - `yayVotes` number, float, required
    - `nayVotes` number, float, required
    - `abstainVotes` number, float, required
  - `pagination` Pagination, required
    - `page` string
    - `perPage` string
    - `totalPages` string
    - `totalItems` string

## Changes

> 50 revisions in range; 1 not diffed.

- **2025-07-24** `b04af842544e` — 7 breaking
  - the `results/items/abstainVotes` response's property type changed from `string` to `number`, and format from no format to `float` for status `200`
  - the `results/items/activationEpoch` response's property type changed from `string` to `number` for status `200`
  - the `results/items/endEpoch` response's property type changed from `string` to `number` for status `200`
  - the `results/items/id` response's property type changed from `string` to `number` for status `200`
  - …3 more
- **2025-03-14** `eb65b9fb021c` — 1 warning, 1 info
  - added the new `executedRejected` enum value to the `results/items/status` response property for the response status `200`
  - removed the `ExecutedRejected` enum value from the `results/items/status` response property for the response status `200`
- **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`
- …earlier changes not shown

[Full 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-service-production.skmtc.workers.dev/v1/apis/namada-net/namada-interface-indexer-rest-api/revisions/89e2cef092d6/schema)