---
title: "List the caller's OAuth grants"
method: GET
path: "/v1/oauth/grants"
tags: ["oauth"]
---

# List the caller's OAuth grants

`GET /v1/oauth/grants`

## Request

- Base URL: `https://api.typenode.ai`
- URL: `https://api.typenode.ai/v1/oauth/grants`
- Auth: HTTP bearer

## Response `200`

The authenticated user's complete tenant-bound grant list.

- OAuthGrants
  - `data` OAuthGrant[], required
    - `as_issuer` string, uri, required
    - `audience` string, uri, required
    - `capabilities` string[], required
    - `client_id` string, required
    - `client_name` string, required
    - `connection_name` string, required
    - `created_at` integer, required
    - `environment_ids` string[], required
    - `expires_at` integer, nullable, required
    - `grant_id` string, uuid, required
    - `lapses_at` integer, nullable, required
    - `last_used_at` integer, nullable, required
    - `offline_access` boolean, required
    - `resources` OAuthResourceRestriction[], required
      - `resourceId` string, uuid, required
      - `resourceType` string, required
  - `has_more` false, required
  - `next_cursor` unknown, required

## Other responses

- `401`: Authentication required.
- `403`: oauth_client.read is required.
- `502`: The OAuth issuer could not list grants.
- `default`: An error occurred (RFC 9457 problem+json).

---

[API](https://skmtc.dev/typenode/apis/typenode-management-api.md) · [All operations](https://skmtc.dev/typenode/apis/typenode-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typenode/apis/typenode-management-api/revisions/9b943024aa98?raw)