Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

The data.access_token value from Get access token.

Headers

X-Api-Version
string

Version applied to this request. It wins over your account's pinned version — see Versioning.

Example:

"2026-04-14"

Query Parameters

user_ids
string
required

Up to 100 sub-clients, comma-separated. A repeated id counts once.

A sub-client that is not yours returns nothing, not an error.

Example:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee,bbbbbbbb-cccc-dddd-eeee-ffffffffffff"

capability
string

Return only the events for this capability code — see Values.

Example:

"pobo"

latest
enum<string>
default:false

true keeps only each sub-client's newest event per capability, which is the one that says whether it holds it now.

Available options:
true,
false

Response

The grant events.

grants
object[]

The recorded events newest first, then the projected ones.

total
integer

How many events are in grants.