Proposals

get https://{network-cosmos}.gateway.tatum.io/api/cosmos/gov/v1beta1/proposals

Proposals queries all proposals based on given status.

Query Params

proposal_status

string

Defaults to PROPOSAL_STATUS_UNSPECIFIED

proposal_status defines the status of the proposals.

PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal 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.

voter

string

voter defines the voter address for the proposals.

depositor

string

depositor defines the deposit addresses from the proposals.

pagination.key

string

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

string

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

string

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_total

boolean

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

boolean

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

Responses

Language

Credentials

Header

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://cosmos-mainnet.gateway.tatum.io/api/cosmos/gov/v1beta1/proposals?proposal_status=PROPOSAL_STATUS_UNSPECIFIED' \
3
     --header 'accept: */*' \
4
     --header 'x-api-key: t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418'

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

*/*

200A successful response.

defaultAn unexpected error response.