---
title: "List org authorized clients"
method: GET
path: "/api/v2/org_authorized_clients"
tags: ["Org Authorized Clients"]
---

# List org authorized clients

`GET /api/v2/org_authorized_clients`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/org_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: `org_authorized_apps_read`

Get a list of all OAuth2 clients authorized for the current organization.

## Query parameters

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

## Response `200`

OK

- OrgAuthorizedClientsResponse: Response containing a list of org authorized clients.
  - `data` OrgAuthorizedClientData[], required: List of org authorized client data objects.
    - `attributes` OrgAuthorizedClientAttributes, required: Attributes of an org authorized client.
      - `disabled` boolean, required: Whether the organization has disabled this client.
      - `last_exercised` string, date-time, nullable, required: The date and time this client was last exercised.
      - `user_count` integer, required: The number of users in the organization who have authorized this client.
    - `id` string, required: The unique identifier of the org authorized client.
    - `relationships` OrgAuthorizedClientRelationships, required: Relationships for an org authorized client.
      - `oauth2_client` OrgAuthorizedClientRelationshipOAuth2Client, required: Relationship to the OAuth2 client for this org authorized client.
        - `data` OrgAuthorizedClientRelationshipOAuth2ClientData, required: Data identifying the OAuth2 client associated with this org authorized client.
          - `id` string, required: The ID of the OAuth2 client.
          - `type` 'oauth2_clients', required: OAuth2 client resource type.
      - `user_authorized_clients` OrgAuthorizedClientRelationshipUserAuthorizedClients, required: Relationship to the user authorized clients for this org authorized client.
        - `data` OrgAuthorizedClientRelationshipUserAuthorizedClientsData[], required: List of user authorized client relationship data objects.
          - `id` string, required: The ID of the user authorized client.
          - `type` 'user_authorized_clients', required: User authorized client resource type.
        - `links` OrgAuthorizedClientRelationshipUserAuthorizedClientsLinks, required: Links for the user authorized clients relationship.
          - `related` string, required: Link to the user authorized clients for this org authorized client.
    - `type` 'org_authorized_clients', required: The resource type for org 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)