Proposals

Proposals queries all proposals based on given status.

get

Query parameters

proposal_statusstring · enumOptional

proposal_status defines the status of the proposals.

• PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default propopsal status.
• PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
• PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
• PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
• PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
• PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.

Possible values:

voterstringOptional

voter defines the voter address for the proposals.

depositorstringOptional

depositor defines the deposit addresses from the proposals.

pagination.keystringOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalboolean · booleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverseboolean · booleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

200

A successful response.

application/json

default

An unexpected error response

application/json

get

HTTPcURLJavaScriptPython

GET /cosmos/gov/v1beta1/proposals HTTP/1.1
Host: axelar.nownodes.io
Accept: */*

{
  "proposals": [
    {
      "proposal_id": "text",
      "content": {
        "type_url": "text",
        "value": "text"
      },
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes": "text",
        "abstain": "text",
        "no": "text",
        "no_with_veto": "text"
      },
      "submit_time": "2025-06-03T01:42:36.718Z",
      "deposit_end_time": "2025-06-03T01:42:36.718Z",
      "total_deposit": [
        {
          "denom": "text",
          "amount": "text"
        }
      ],
      "voting_start_time": "2025-06-03T01:42:36.718Z",
      "voting_end_time": "2025-06-03T01:42:36.718Z"
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

Proposal queries proposal details based on ProposalID.

get

Path parameters

proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Responses

200

A successful response.

application/json

default

An unexpected error response

application/json

get

HTTPcURLJavaScriptPython

GET /cosmos/gov/v1beta1/proposals/{proposal_id} HTTP/1.1
Host: axelar.nownodes.io
Accept: */*

{
  "proposal": {
    "proposal_id": "text",
    "content": {
      "type_url": "text",
      "value": "text"
    },
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes": "text",
      "abstain": "text",
      "no": "text",
      "no_with_veto": "text"
    },
    "submit_time": "2025-06-03T01:42:36.718Z",
    "deposit_end_time": "2025-06-03T01:42:36.718Z",
    "total_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "voting_start_time": "2025-06-03T01:42:36.718Z",
    "voting_end_time": "2025-06-03T01:42:36.718Z"
  }
}