> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/cosmos/cosmos-rest-api/gov-proposals-cosmos.md).

# gov proposals - Cosmos

Example code for the gov proposals REST method. Complete guide on how to use the gov proposals REST method in GetBlock Web3 documentation.

Returns governance proposals, optionally filtered by status, paginated.

## Endpoint

```http
GET /cosmos/gov/v1/proposals
```

## Query Parameters

| Parameter        | Type   | Description                                             |
| ---------------- | ------ | ------------------------------------------------------- |
| proposal\_status | string | Filter by status, e.g. PROPOSAL\_STATUS\_VOTING\_PERIOD |
| pagination.limit | string | Max results per page                                    |

## Example

{% code overflow="wrap" %}

```bash
export COSMOS_REST=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

curl "${COSMOS_REST}cosmos/gov/v1/proposals"
```

{% endcode %}

## Response

```json
{
    "proposals": [
        {
            "id": "900",
            "status": "PROPOSAL_STATUS_VOTING_PERIOD",
            "messages": [],
            "final_tally_result": {
                "yes_count": "0",
                "no_count": "0"
            },
            "submit_time": "2026-05-20T00:00:00Z",
            "voting_end_time": "2026-06-03T00:00:00Z"
        }
    ],
    "pagination": {
        "total": "900"
    }
}
```

## Response Fields

| Field                             | Type   | Description                                             |
| --------------------------------- | ------ | ------------------------------------------------------- |
| proposals                         | array  | Governance proposals with status, messages, and tallies |
| proposals\[].status               | string | Proposal lifecycle status                               |
| proposals\[].final\_tally\_result | object | Vote tally for the proposal                             |

## Use Cases

* **Governance UI**: List active and past proposals
* **Monitoring**: Track proposals in the voting period

## Error Handling

| Error                     | Message       | Description                                                  |
| ------------------------- | ------------- | ------------------------------------------------------------ |
| 400 / Bad request         | Bad request   | A path, query, or body parameter was invalid                 |
| 404 / Not found           | Not found     | The account, validator, proposal, or resource does not exist |
| 403 / RBAC: access denied | Access denied | The GetBlock access token is missing or incorrect            |
