---
title: "List OAuth clients"
method: GET
path: "/oauth/clients"
tags: ["OAuth Clients"]
---

# List OAuth clients

`GET /oauth/clients`

Retrieve a paginated list of OAuth clients for the authenticated user

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter[client_type]` 'confidential' | 'public'
- `filter[verified]` boolean
- `filter[allowed_grant_types][contains]` 'client_credentials' | 'authorization_code' | 'refresh_token'
- `filter[name]` string
- `filter[name][contains]` string
- `filter[client_id]` string

## Response `200`

List of OAuth clients

- object
  - `data` OAuthClient[]
    - `allowed_grant_types` string[] — List of allowed OAuth grant types
    - `allowed_scopes` string[] — List of allowed OAuth scopes
    - `client_id` string, required — OAuth client identifier
    - `client_secret` string, nullable — Client secret (only included when available, for confidential clients)
    - `client_type` 'public' | 'confidential', required — OAuth client type
    - `created_at` string, date-time, required — Timestamp when the client was created
    - `logo_uri` string, uri, nullable — URL of the client logo
    - `name` string, required — Human-readable name for the OAuth client
    - `org_id` string, required — Organization ID that owns this OAuth client
    - `policy_uri` string, uri, nullable — URL of the client's privacy policy
    - `record_type` 'oauth_client', required — Record type identifier
    - `redirect_uris` string[] — List of allowed redirect URIs
    - `require_pkce` boolean, required — Whether PKCE (Proof Key for Code Exchange) is required for this client
    - `tos_uri` string, uri, nullable — URL of the client's terms of service
    - `updated_at` string, date-time, required — Timestamp when the client was last updated
    - `user_id` string, required — User ID that created this OAuth client
  - `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

- `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/ec31f78cf002/schema)