---
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`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)