Proposal queries a proposal based on proposal id.

get https://example.com/cosmos/group/v1/proposal/{proposal_id}

Responses

Response body

object

proposal

object

proposal is the proposal info.

string

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

array of strings

proposers are the account addresses of the proposers.

proposers

submit_time

date-time

submit_time is a timestamp specifying when a proposal was submitted.

group_version

string

group_version tracks the version of the group at proposal submission.
This field is here for informational purposes only.

group_policy_version

string

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

string

Defaults to PROPOSAL_STATUS_UNSPECIFIED

status represents the high level position in the life cycle of the proposal. Initial value is Submitted.

PROPOSAL_STATUS_UNSPECIFIED PROPOSAL_STATUS_SUBMITTED PROPOSAL_STATUS_ACCEPTED PROPOSAL_STATUS_REJECTED PROPOSAL_STATUS_ABORTED PROPOSAL_STATUS_WITHDRAWN

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.

voting_period_end

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_resultand status fields will be
accordingly updated.

executor_result

string

Defaults to PROPOSAL_EXECUTOR_RESULT_UNSPECIFIED

executor_result is the final result of the proposal execution. Initial value is NotRun.

PROPOSAL_EXECUTOR_RESULT_UNSPECIFIED PROPOSAL_EXECUTOR_RESULT_NOT_RUN PROPOSAL_EXECUTOR_RESULT_SUCCESS PROPOSAL_EXECUTOR_RESULT_FAILURE

messages

array of objects

messages is a list of sdk.Msgs that will be executed if the proposal passes.

messages

object

@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.

Schemes other than http, https (or the empty scheme) might be
used with implementation specific semantics.

title

string

summary

string

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://example.com/cosmos/group/v1/proposal/proposal_id \
3
     --header 'accept: */*'

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200A successful response.

defaultAn unexpected error response.