---
title: "List org group policy suggestions"
method: GET
path: "/api/v2/org_group_policy_suggestions"
tags: ["Org Groups"]
---

# List org group policy suggestions

`GET /api/v2/org_group_policy_suggestions`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/org_group_policy_suggestions`
- 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`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/org_group_policy_suggestions/get.ts> (a function with typed inputs; its response is checked against the schema)

List suggested organization group policies. Requires a filter on org group ID.

## Query parameters

- `filter[org_group_id]` string, uuid, required

## Response `200`

OK

- OrgGroupPolicySuggestionListResponse: Response containing a list of org group policy suggestions.
  - `data` OrgGroupPolicySuggestionData[], required: An array of org group policy suggestions.
    - `attributes` OrgGroupPolicySuggestionAttributes, required: Attributes of an org group policy suggestion.
      - `consensus_ratio` number, double, required: The ratio of member orgs whose configuration agrees on the recommended value.
      - `policy_name` string, required: The name of the suggested policy.
      - `recommended_value` string, required: The recommended value for the policy, based on member org consensus.
      - `status` 'pending' | 'accepted' | 'dismissed', required: The status of the policy suggestion.
    - `id` string, required: The ID of the org group policy suggestion.
    - `relationships` OrgGroupPolicySuggestionRelationships: Relationships of an org group policy suggestion.
      - `org_group` OrgGroupRelationshipToOne: Relationship to a single org group.
        - `data` OrgGroupRelationshipToOneData, required: A reference to an org group.
          - `id` string, uuid, required: The ID of the org group.
          - `type` 'org_groups', required: Org groups resource type.
    - `type` 'org_group_policy_suggestions', required: Org group policy suggestions resource type.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `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/3f70db624329?raw)