OpenAPI 3.1.02026-08-193894215.9 MB
23dfbe1a0d1f
Users
List OAuth Grants
Lists the authenticated user's own OAuth grants — one per app they have authorized, per account they authorized it for. The list is always the caller's own; there is no parameter for reading another user's grants. Requires a user session: an API key or an OAuth token is refused, so an app can never enumerate the other apps a user has authorized.
get/users/me/oauth_grants
Query parameters
app_idstring
Only return grants for this app, prefixed app_. An app the user has never authorized returns an empty list.
firstinteger
The number of grants to return (default 20, max 100).
afterstring
A cursor; returns grants after this position.
lastinteger
The number of grants to return from the end of the range.
beforestring
A cursor; returns grants before this position.
order'created_at'
The field to sort grants by.
direction'asc' | 'desc'
Sort direction.
Response
oauth grants listed
Example response
{
"data": [
{
"account_id": "biz_xxxxxxxxxxxxxx",
"app_id": "app_xxxxxxxxxxxxxx",
"authorized_at": "2026-01-01T12:00:00.000Z",
"created_at": "2026-01-01T12:00:00.000Z",
"id": "oag_xxxxxxxxxxxxxx",
"redirect_url": "https://Booking.Shinetime.example:8443/oauth/Callback/",
"revoked_at": "2026-01-01T12:00:00.000Z",
"scopes": [
"email"
]
}
],
"page_info": {
"end_cursor": "WyJjdXJzb3IiLDFd",
"start_cursor": "WyJjdXJzb3IiLDFd"
}
}