---
title: "ProposalsByGroupPolicy queries proposals based on account address of group policy."
method: GET
path: "/cosmos/group/v1/proposals_by_group_policy/{address}"
tags: ["Query"]
---

# ProposalsByGroupPolicy queries proposals based on account address of group policy.

`GET /cosmos/group/v1/proposals_by_group_policy/{address}`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `address` string, required

## Query parameters

- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- object: QueryProposalsByGroupPolicyResponse is the Query/ProposalByGroupPolicy response type.
  - `proposals` object[]: proposals are the proposals with given group policy.
    - `id` string, uint64: id is the unique id of the proposal.
    - `group_policy_address` string: group_policy_address is the account address of group policy.
    - `metadata` string
    - `proposers` string[]: proposers are the account addresses of the proposers.
    - `submit_time` string, date-time: submit_time is a timestamp specifying when a proposal was submitted.
    - `group_version` string, uint64: group_version tracks the version of the group at proposal submission. This field is here for informational purposes only.
    - `group_policy_version` string, uint64: group_policy_version tracks the version of the group policy at proposal submission. When a decision policy is changed, existing proposals from previous policy versions will become invalid with the `ABORTED` status. This field is here for informational purposes only.
    - `status` 'PROPOSAL_STATUS_UNSPECIFIED' | 'PROPOSAL_STATUS_SUBMITTED' | 'PROPOSAL_STATUS_ACCEPTED' | 'PROPOSAL_STATUS_REJECTED' | 'PROPOSAL_STATUS_ABORTED' | 'PROPOSAL_STATUS_WITHDRAWN': status represents the high level position in the life cycle of the proposal. Initial value is Submitted.
    - `final_tally_result` object: final_tally_result contains the sums of all weighted votes for this proposal for each vote option. It is empty at submission, and only populated after tallying, at voting period end or at proposal execution, whichever happens first.
      - `yes_count` string: yes_count is the weighted sum of yes votes.
      - `abstain_count` string: abstain_count is the weighted sum of abstainers.
      - `no_count` string: no_count is the weighted sum of no votes.
      - `no_with_veto_count` string: no_with_veto_count is the weighted sum of veto.
    - `voting_period_end` string, date-time: voting_period_end is the timestamp before which voting must be done. Unless a successful MsgExec is called before (to execute a proposal whose tally is successful before the voting period ends), tallying will be done at this point, and the `final_tally_result`and `status` fields will be accordingly updated.
    - `executor_result` 'PROPOSAL_EXECUTOR_RESULT_UNSPECIFIED' | 'PROPOSAL_EXECUTOR_RESULT_NOT_RUN' | 'PROPOSAL_EXECUTOR_RESULT_SUCCESS' | 'PROPOSAL_EXECUTOR_RESULT_FAILURE': executor_result is the final result of the proposal execution. Initial value is NotRun.
    - `messages` object[]: messages is a list of `sdk.Msg`s that will be executed if the proposal passes.
      - `@type` string: A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in `path/google.protobuf.Duration`). The name should be in a canonical form (e.g., leading "." is not accepted). In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme `http`, `https`, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows: * If no scheme is provided, `https` is assumed. * An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error. * Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.) Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one. Schemes other than `http`, `https` (or the empty scheme) might be used with implementation specific semantics.
    - `title` string
    - `summary` string
  - `pagination` object: pagination defines the pagination in the response.
    - `next_key` string, byte: next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-01-28** `7ee619f48b09`: 1 info
  - endpoint added
- **2024-03-22** `f6ed714cd62d`: 1 breaking
  - api path removed without deprecation
- **2024-03-22** `426ef0503938`: 1 info
  - endpoint added
- **2024-02-21** `9da39c06448a`: 1 breaking
  - api path removed without deprecation
- **2024-02-07** `0345868c59cf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/changes/cosmos/group/v1/proposals_by_group_policy/:address/get.md)

---

[API](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/tellor-io/apis/layer-grpc-gateway-docs/revisions/52aa42be34ad?raw)