v1

latestOpenAPI 3.0.32026-07-173986194.3 KB

Returns a list of governance proposals.

get/consensus/proposals

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

The number of items to skip before starting to collect the result set.

submitterstring

An Oasis-style (bech32) address.

Example:oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p

Filter on the submitter of the proposal.

state'active' | 'passed' | 'failed' | 'rejected'

The state of the proposal.

Example:active

Filter on the state of the proposal.

Response

A JSON object containing a list of governance proposals.

total_countinteger 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_clippedboolean required

Whether total_count is clipped for performance reasons.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "proposals": [
    {
      "id": 1,
      "submitter": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
      "state": "active",
      "deposit": "1234567890123456789012",
      "epoch": 13402,
      "parameters_change": "{\"min_validators\":null,\"max_validators\":\"120\",\"voting_power_distribution\":null}",
      "created_at": 13402,
      "closes_at": 13403,
      "invalid_votes": "1234567890123456789012"
    }
  ]
}