---
title: "List user authorized clients"
method: GET
path: "/api/v2/user_authorized_clients"
tags: ["User Authorized Clients"]
---

# List user authorized clients

`GET /api/v2/user_authorized_clients`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/user_authorized_clients`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `built_in_features`

Get a list of all OAuth2 clients authorized by the current user.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter` string
- `filter[disabled]` string
- `include` string

## Response `200`

OK

- UserAuthorizedClientsResponse: Response containing a list of user authorized clients.
  - `data` UserAuthorizedClientData[], required: List of user authorized client data objects.
    - `attributes` UserAuthorizedClientAttributes, required: Attributes of a user authorized client.
      - `created_at` string, date-time, required: The date and time this authorization was created.
      - `disabled` boolean, required: Whether the user has disabled this authorization.
      - `last_exercised` string, date-time, nullable, required: The date and time this authorization was last exercised.
      - `modified_at` string, date-time, required: The date and time this authorization was last modified.
      - `org_disabled` boolean, required: Whether the organization has disabled this authorization.
    - `id` string, required: The unique identifier of the user authorized client.
    - `relationships` UserAuthorizedClientRelationships, required: Relationships for a user authorized client.
      - `oauth2_client` UserAuthorizedClientRelationshipOAuth2Client, required: Relationship to the OAuth2 client that was authorized.
        - `data` UserAuthorizedClientRelationshipOAuth2ClientData, required: Data identifying the OAuth2 client that was authorized.
          - `id` string, required: The ID of the OAuth2 client.
          - `type` 'oauth2_clients', required: OAuth2 client resource type.
      - `scopes` UserAuthorizedClientRelationshipScopes, required: Relationship to the scopes granted to the OAuth2 client.
        - `data` UserAuthorizedClientRelationshipScopeData[], required: List of scope relationship data objects.
          - `id` string, required: The identifier of the scope.
          - `type` 'scopes', required: Scope resource type.
      - `user` UserAuthorizedClientRelationshipUser, required: Relationship to the user who granted this authorization.
        - `data` UserAuthorizedClientRelationshipUserData, required: Data identifying the user who granted this authorization.
          - `id` string, required: The ID of the user.
          - `type` 'users', required: User resource type.
    - `type` 'user_authorized_clients', required: The resource type for user authorized clients.
  - `meta` ResponseMetaAttributes, required: Object describing meta attributes of response.
    - `page` Pagination: Pagination object.
      - `total_count` integer: Total count.
      - `total_filtered_count` integer: Total count of elements matched by the filter.

## Other responses

- `403`: Authentication error
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)