List the partner's grants

The partner’s grants, live and revoked, in the order they last changed (granted, or revoked), then by id, for reconciling after a missed webhook: page with next_cursor until it is null. status keeps the live or the revoked ones; changed_since keeps those granted or revoked at or after it. A grant whose pilot deleted his account is removed with the account and appears in no list; its grant.revoked event was queued first.

GET /v1/partner/grants

List the partner's grants

cURL

curl --request GET \
  --url https://{devApiHost}/v1/partner/grants \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "grant_id": "6f1c2a9e-3b7d-4c51-9e2a-0d4b8f6a1c33",
      "pilot_id": "2d9b7c1e-8f4a-4e3b-a6d5-91c0f2e7b844",
      "scopes": [
        "hours.write",
        "profile"
      ],
      "granted_at": "2026-11-04T12:00:00Z",
      "revoked_at": "2026-11-05T09:30:00Z",
      "revoked_reason": "pilot"
    }
  ],
  "next_cursor": null
}

Authorizations

Authorization · string · header · required

OAuth 2.0 client credentials. Request a token from the token endpoint of the identity provider's domain (https://{cognito-domain}/oauth2/token, with HTTP Basic client authentication) and send it as a Bearer token. Production uses auth.mypilotindex.com. The sandbox uses the dev environment's Cognito domain, which is given to the partner with its sandbox credential. A token carries only the scopes the partner was approved for.

Query Parameters

status · enum<string>

active (live) or revoked; absent lists both.

Available options: active, revoked

changed_since · string<date-time>

An RFC 3339 timestamp; only grants granted or revoked at or after it.

limit · integer · default: 100

Required range: 1 <= x <= 500

cursor · string

The next_cursor of the previous page, as it came; opaque.

Response

200

application/json

One page of grants.

items · object[] · required

Show child attributes

next_cursor · string | null · required

Continues the list after the last item; null on the last page.