---
title: "View a connected app"
method: GET
path: "/v0/users/{user}/oauth/grants/{grant}"
tags: ["users", "oauth"]
---

# View a connected app

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

## Request

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

View an app connected to a user's account through OAuth. Only the user themselves and server admins have access, with a JWT (user session token).

## Path parameters

- `grant` string, uuid, required
- `user` string, required

## Response `200`

successful operation

- JsonOAuthGrant: An app connected to a user's account through OAuth.
  - `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 `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/:grant/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)