---
title: "Read an OAuth authorization request: the consent view"
method: GET
path: "/v1/account/oauth/requests/{id}"
---

# Read an OAuth authorization request: the consent view

`GET /v1/account/oauth/requests/{id}`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/oauth/requests/{id}`
- Auth: API key in cookie `rove_session`

## Path parameters

- `id` string, required

## Response `200`

Successful response (Cache-Control: no-store)

- object
  - `request_id` string, required
  - `client` object, required
    - `client_id` string, required
    - `name` string, required
    - `name_kind` 'asserted' | 'redirect_host' | 'this_computer', required: Where the display name came from. 'asserted' names are supplied by the app and not verified.
    - `name_verified` false, required
  - `redirect` object, required
    - `host` string, required
    - `kind` 'web' | 'loopback', required
  - `scopes_requested` object[], required
    - `scope` 'rove:browse' | 'rove:supervised', required
    - `title` string, required
    - `line` string, required
  - `existing_grant` object, nullable, required
    - `scopes` object[], required
      - `scope` 'rove:browse' | 'rove:supervised', required
      - `title` string, required
    - `created_at` string, date-time, required
  - `choices` object[], required
    - `choice` 'allow' | 'allow_browse' | 'deny', required
    - `scopes` string[], required
    - `adds` string[], required
    - `removes` string[], required
    - `leaves_connected` boolean, required
  - `expires_at` string, date-time, required
  - `signed_in_as` string, required

## Other responses

- `401`: RFC 7807 owner-session-required: sign in
- `403`: RFC 7807 owner-origin-refused (mutations only)
- `409`: RFC 7807 oauth-request-completed: already decided by this account
- `410`: RFC 7807 oauth-request-spent: expired, decided by another account, or unknown
- `429`: RFC 7807 rate-limit-exceeded: 120 reads per minute per account; Retry-After
- `503`: RFC 7807 account-service-unavailable; Retry-After: 30

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)
