Skip to main content

/cosmos/authz/v1beta1/grants REST API Endpoint

Returns list of Authorization, granted to the grantee by the granter.

Updated on
Mar 21, 2025

Query Parameters

granter
string
REQUIRED

The granter

grantee
string
REQUIRED

The grantee

msg_type_url
string

(Optional) when set, will query only grants matching given msg type

pagination.key
string

The 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

The 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

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

When set to true it 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

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

Returns

grants
array

An array of grants, which contains the following fields:

authorization
object

The authorization object which contains the following fields:

type_url
string

The type of authorization

value
string

The value of the authorization

expiration
string

The time when the grant will expire and will be pruned. If null, then the grant doesn't have a time expiration

pagination
object

The pagination object which contains the following fields:

next_key
string

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

The total number of results available if PageRequest.count_total was set, its value is undefined otherwise

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free