---
title: "List OAuth grants"
method: GET
path: "/oauth_grants"
tags: ["OAuth Grants"]
---

# List OAuth grants

`GET /oauth_grants`

Retrieve a paginated list of OAuth grants for the authenticated user

## Query parameters

- `page[size]` integer
- `page[number]` integer

## Response `200`

List of OAuth grants

- object
  - `data` OAuthGrant[]
    - `client_id` string, required — OAuth client identifier
    - `created_at` string, date-time, required — Timestamp when the grant was created
    - `id` string, uuid, required — Unique identifier for the OAuth grant
    - `last_used_at` string, date-time, nullable — Timestamp when the grant was last used
    - `record_type` 'oauth_grant', required — Record type identifier
    - `scopes` string[], required — List of granted OAuth scopes
  - `meta` OauthPaginationMeta
    - `page_number` integer — Current page number
    - `page_size` integer — Number of items per page
    - `total_pages` integer — Total number of pages
    - `total_results` integer — Total number of results

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)