---
title: "List proposal info"
method: GET
path: "/proposal"
tags: ["proposal"]
---

# List proposal info

`GET /proposal`

Returns a paginated list of governance proposals. Supports filtering by proposer address, status, and type.

## Query parameters

- `limit` integer
- `offset` integer
- `sort` 'asc' | 'desc'
- `proposer` string
- `status` string
- `type` string

## Response `200`

OK

- ResponsesProposal[]
  - `abstain` integer
  - `abstain_addrs` integer
  - `abstain_vals` integer
  - `abstain_voting_power` string, string
  - `activation_time` string, date-time
  - `created_at` string, date-time
  - `deposit` string, string
  - `deposit_time` string, date-time
  - `description` string, string
  - `end_time` string, date-time
  - `error` string, string
  - `height` integer
  - `id` integer
  - `metadata` string, string
  - `min_deposit` string, string
  - `no` integer
  - `no_addrs` integer
  - `no_vals` integer
  - `no_voting_power` string, string
  - `no_with_veto` integer
  - `no_with_veto_addrs` integer
  - `no_with_veto_vals` integer
  - `no_with_veto_voting_power` string, string
  - `proposer` ResponsesShortAddress
    - `celestials` ResponsesCelestial — Linked celestial id
      - `image_url` string
      - `name` string
      - `primary` boolean
      - `status` string
    - `hash` string
  - `quorum` string, string
  - `status` string, string
  - `threshold` string, string
  - `title` string, string
  - `total_voting_power` string, string
  - `type` string, string
  - `veto_quorum` string, string
  - `votes_count` integer
  - `voting_power` string, string
  - `yes` integer
  - `yes_addrs` integer
  - `yes_vals` integer
  - `yes_voting_power` string, string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

> 52 revisions in range; 29 could not be searched.

- **2024-10-13** `2ec1cffe67d5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/celenium-io/apis/celenium-api/changes/proposal/get.md)

---

[API](https://skmtc.dev/celenium-io/apis/celenium-api.md) · [All operations](https://skmtc.dev/celenium-io/apis/celenium-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celenium-io/celenium-api/revisions/117307f84924/schema)