---
title: "List the account's connected apps (active grants only)"
method: GET
path: "/v1/account/oauth/grants"
---

# List the account's connected apps (active grants only)

`GET /v1/account/oauth/grants`

## Request

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

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Successful response (Cache-Control: no-store)

- object
  - `items` object[], required: Active grants only, newest first.
    - `grant_id` string, uuid, 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.
    - `redirect` object, required
      - `host` string, required
      - `kind` 'web' | 'loopback', required
    - `scopes` string[], required
    - `api_key_id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `last_token_issued_at` string, date-time, nullable, required
    - `signed_out_for_safety_at` string, date-time, nullable, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: RFC 7807 invalid-cursor or invalid-params
- `401`: RFC 7807 owner-session-required: sign in
- `403`: RFC 7807 owner-origin-refused (mutations only)
- `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)