---
title: "List connected apps"
method: GET
path: "/v0/users/{user}/oauth/grants"
tags: ["users", "oauth"]
---

# List connected apps

`GET /v0/users/{user}/oauth/grants`

## Request

- The document declares no server URL.
- Auth: none declared

List the apps connected to a user's account through OAuth that can still act for the user. Only the user themselves and server admins have access, with a JWT (user session token). The HTTP response header `X-Total-Count` contains the total number of apps.

## Path parameters

- `user` string, required

## Query parameters

- `direction` 'asc' | 'desc'
- `page` integer, nullable
- `per_page` integer, nullable
- `sort` 'created': Sort by when the app was connected.

## Response `200`

successful operation

- JsonOAuthGrant[]
  - `client` JsonOAuthClient, required: The app an OAuth grant was given to.
    - `host` string, required: The host serving the app's metadata document, which is who the app is.
    - `id` string, required: An OAuth client identifier: the URL of the client's metadata document.
    - `name` string, required
  - `created` string, date-time, required
  - `expiration` string, date-time, required
  - `modified` string, date-time, required
  - `scopes` OAuthScope[], required
    - union: An OAuth scope: what a client may do on the user's behalf.
      - 'projects:read': Read the projects the user can read.
      - 'projects:write': Read and write the projects the user can write.
      - 'openid': Who the user is.
      - 'email': The user's email address.
      - 'profile': The user's name.
  - `user_key` JsonOAuthGrantKey: The user API key an OAuth grant was approved with.
    - `name` string, required
    - `uuid` string, uuid, required
  - `uuid` string, uuid, required

## Other responses

- `4XX`: Error
- `5XX`: Error

## Changes

- **2026-10-19** `dd30ea8731a7`: 1 breaking
  - added `subschema #3, subschema #4, subschema #5` to the `items/scopes/items/` response property `oneOf` list for the response status `200`
- **2026-10-19** `7f2d03f87994`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/users/:user/oauth/grants/get.md)

---

[API](https://skmtc.dev/bencherdev/apis/bencher-api.md) - [All operations](https://skmtc.dev/bencherdev/apis/bencher-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bencherdev/apis/bencher-api/revisions/538b39b8d755?raw)