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

# List OAuth clients

`GET /oauth/clients`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/oauth/clients`
- Auth: HTTP bearer

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

## Other responses

- `401`: Unauthorized

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/oauth/clients/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)