Users

List OAuth Grants

Changed on

Lists the authenticated user's own OAuth grants: one per app they have authorized, per account they authorized it for. You cannot read 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

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/users/me/oauth_grants
  • Auth: HTTP bearer

Query parameters

app_idstring

Only return grants for this app, prefixed app_. An app the user has never authorized returns an empty list.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

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": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • ff3a76573563Revision changes
    • breaking

      for the query request parameter first, default value 20 was added

    • warning

      for the query request parameter first, the max was set to 100.00

    • warning

      for the query request parameter last, the max was set to 100.00

  • f1020c3ecda4Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status