---
title: Search remediation groups
description: Search the remediation groups of your organization.
breadcrumbs: Docs > API > Search remediation groups
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Search remediation groups

## v2 (latest)

{% alert level="warning" %}
**Note**: This endpoint is in preview and is subject to change.
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help.md).
{% /alert %}

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/security/remediation_groups     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/security/remediation_groups |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/security/remediation_groups |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/security/remediation_groups      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/security/remediation_groups |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/security/remediation_groups |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/security/remediation_groups |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/security/remediation_groups      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/security/remediation_groups  |

### Overview

Search the remediation groups of your organization. A remediation group gathers the open security findings
that one change fixes, such as updating a package in a repository or upgrading an image.

Each group comes from a grouping definition, which sets the finding type it covers and the kind object the
group returns:

| Grouping definition    | Finding type                       | Kind object      |
| ---------------------- | ---------------------------------- | ---------------- |
| `sca.package_update`   | `library_vulnerability`            | `package_update` |
| `cloudvm.image_update` | `host_and_container_vulnerability` | `image_update`   |

Groups are computed from the attributes of security findings, described in the
[security findings schema](https://docs.datadoghq.com/security/guide/findings-schema.md). The description of
each kind object lists the findings its grouping definition reads and the attribute each field comes from.

The search includes all open findings, regardless of when they were first detected.

This endpoint requires the `cases_read` permission and either the `security_monitoring_findings_read` or
`appsec_vm_read` permission.

This endpoint requires any of the following permissions:

- `security_monitoring_findings_read`
- `appsec_vm_read`

OAuth apps require the `security_monitoring_findings_read`, `cases_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#security-monitoring) to access this endpoint.

### Arguments

#### Query Strings

| Field                | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| filter[finding_type] | array   | Returns only groups whose grouping definition covers this `@finding_type` value. To match more than one finding type, repeat the parameter.                                                                                                                                                                                                                                                                                                                                                                                 |
| filter[query]        | string  | Returns only groups with at least one open finding that matches the query. Use the security findings search syntax with attributes from the [security findings schema](https://docs.datadoghq.com/security/guide/findings-schema.md), prefixed by `@`. For example, `@severity:(critical OR high)` returns groups with at least one critical or high finding. The group's counts still include every finding in the group. The query can be at most 2048 bytes after JSON encoding, and the parameter can appear only once. |
| sort                 | string  | Comma-separated list of sort fields. Prefix a field with `-` to sort in descending order. `findings.by_severity` sorts by the critical count, then high, medium, low, info, none, and unknown. `findings.total` sorts by the total finding count. By default, groups are sorted by critical count, then high count, then total finding count, all in descending order.                                                                                                                                                      |
| page[size]           | integer | Number of groups in a page. Default: `50`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| page[number]         | integer | Page to return, starting at 1. Default: `1`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| include              | enum    | Adds each group's case to `included`. `case` is the only supported value. Allowed enum values: `case`.                                                                                                                                                                                                                                                                                                                                                                                                                      |

### Response

{% tabs %}
{% tab label="200" %}
OK

{% tabs %}
{% tab label="Model" %}
A page of remediation groups.

| Parent field         | Field                               | Type      | Description                                                                                                                                                                                                                                                                                                                      |
| -------------------- | ----------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|                      | data [*required*]                   | [object]  | Remediation groups of the page.                                                                                                                                                                                                                                                                                                  |
| data                 | attributes [*required*]             | object    | Attributes of a remediation group. Each group includes one kind object, `package_update` or `image_update`, depending on its grouping definition.                                                                                                                                                                                |
| attributes           | findings [*required*]               | object    | Counts of the group's open findings. The counts include every finding in the group, including findings that don't match `filter[query]`.                                                                                                                                                                                         |
| findings             | by_severity [*required*]            | object    | Number of the group's findings for each value of their `@severity` attribute. The response includes every level, including levels with a count of zero.                                                                                                                                                                          |
| by_severity          | critical [*required*]               | int64     | Number of critical findings.                                                                                                                                                                                                                                                                                                     |
| by_severity          | high [*required*]                   | int64     | Number of high findings.                                                                                                                                                                                                                                                                                                         |
| by_severity          | info [*required*]                   | int64     | Number of info findings.                                                                                                                                                                                                                                                                                                         |
| by_severity          | low [*required*]                    | int64     | Number of low findings.                                                                                                                                                                                                                                                                                                          |
| by_severity          | medium [*required*]                 | int64     | Number of medium findings.                                                                                                                                                                                                                                                                                                       |
| by_severity          | none [*required*]                   | int64     | Number of findings with no severity.                                                                                                                                                                                                                                                                                             |
| by_severity          | unknown [*required*]                | int64     | Number of findings with an unknown severity.                                                                                                                                                                                                                                                                                     |
| findings             | total [*required*]                  | int64     | Number of open findings in the group.                                                                                                                                                                                                                                                                                            |
| attributes           | grouping_definition_id [*required*] | string    | Grouping definition that formed the group: `sca.package_update` or `cloudvm.image_update`.                                                                                                                                                                                                                                       |
| attributes           | image_update                        | object    | An image or package to upgrade, for a group of host and container vulnerabilities (`cloudvm.image_update`). The group gathers the open vulnerabilities of running production images that have a fix available, and groups them by `grouping_location`, `remediation_kind`, and `action`.                                         |
| image_update         | action [*required*]                 | string    | Name of the container image, base image, or package to upgrade. The value comes from the first of these attributes that the findings have: `@remediation.container_image.latest_major.name`, `@remediation.base_image.latest_major.name`, or `@remediation.recommended.name`.                                                    |
| image_update         | advisory_count [*required*]         | int64     | Number of distinct values of `@advisory.id` across the group's findings.                                                                                                                                                                                                                                                         |
| image_update         | exploitable_cve_count [*required*]  | int64     | Number of distinct values of `@advisory.id` across the group's findings that have `@risk.has_exploit_available` set to `true`.                                                                                                                                                                                                   |
| image_update         | file_count [*required*]             | int64     | Number of distinct values of `@code_location.filename` across the group's findings.                                                                                                                                                                                                                                              |
| image_update         | grouping_location [*required*]      | string    | File that contains the findings, from their `@code_location.filename` attribute. When no file is known, the value is the findings' `@container_image.name`.                                                                                                                                                                      |
| image_update         | location_is_filename [*required*]   | boolean   | Whether `grouping_location` is a `@code_location.filename` rather than a `@container_image.name`.                                                                                                                                                                                                                                |
| image_update         | remediation_kind [*required*]       | string    | Kind of upgrade: `image_update` when the findings have a `@remediation.container_image.latest_major.name`, `base_image_bump` when they have `@vulnerability.is_inherited_from_base_image` set to `true`, and `package_update` otherwise.                                                                                         |
| image_update         | target_version                      | string    | Version to upgrade to: the `@remediation.container_image.latest_major.tag` or `@remediation.base_image.latest_major.tag` of the image in `action`, or else the highest `@remediation.recommended.version` across the group's findings. Omitted when no version is recommended or when the recommended versions can't be ordered. |
| attributes           | package_update                      | object    | A package to update in a repository, for a group of library vulnerabilities (`sca.package_update`). The group gathers the open vulnerabilities of direct dependencies that have a recommended fix, and groups them by `@git.repository_id`, `@vulnerability.stack.ecosystem`, and `@remediation.recommended.name`.               |
| package_update       | advisory_count [*required*]         | int64     | Number of distinct values of `@advisory.id` across the group's findings.                                                                                                                                                                                                                                                         |
| package_update       | ecosystem [*required*]              | string    | Package ecosystem, the findings' `@vulnerability.stack.ecosystem`.                                                                                                                                                                                                                                                               |
| package_update       | exploitable_cve_count [*required*]  | int64     | Number of distinct values of `@advisory.id` across the group's findings that have `@risk.has_exploit_available` set to `true`.                                                                                                                                                                                                   |
| package_update       | file_count [*required*]             | int64     | Number of distinct values of `@package.declaration.block.filename`, the files that declare the package.                                                                                                                                                                                                                          |
| package_update       | package_name [*required*]           | string    | Name of the package to update, the findings' `@remediation.recommended.name`.                                                                                                                                                                                                                                                    |
| package_update       | repository_id [*required*]          | string    | Repository that depends on the package, the findings' `@git.repository_id`.                                                                                                                                                                                                                                                      |
| package_update       | target_version                      | string    | Version to update the package to, the highest `@remediation.recommended.version` across the group's findings. Omitted when no version is recommended or when the recommended versions can't be ordered.                                                                                                                          |
| attributes           | title [*required*]                  | string    | Title of the group, which describes the change to make.                                                                                                                                                                                                                                                                          |
| data                 | id [*required*]                     | string    | Remediation key of the group: the grouping definition ID, a colon, and the group's dimensions encoded in base64url. It identifies the group across searches.                                                                                                                                                                     |
| data                 | relationships [*required*]          | object    | Relationships of a remediation group.                                                                                                                                                                                                                                                                                            |
| relationships        | case [*required*]                   | object    | Relationship to the case that tracks the group's remediation.                                                                                                                                                                                                                                                                    |
| case                 | data [*required*]                   | object    | The group's case, or null when the group has no case yet.                                                                                                                                                                                                                                                                        |
| data                 | id [*required*]                     | string    | Unique identifier of the case.                                                                                                                                                                                                                                                                                                   |
| data                 | type [*required*]                   | enum      | Cases resource type. Allowed enum values: `cases`. Default: `cases`.                                                                                                                                                                                                                                                             |
| data                 | type [*required*]                   | enum      | Remediation groups resource type. Allowed enum values: `remediation_groups`. Default: `remediation_groups`.                                                                                                                                                                                                                      |
|                      | included                            | [object]  | Cases of the page's groups, when the request has `include=case`.                                                                                                                                                                                                                                                                 |
| included             | attributes                          | object    | Attributes of the case.                                                                                                                                                                                                                                                                                                          |
| attributes           | archived_at                         | date-time | Timestamp of when the case was archived.                                                                                                                                                                                                                                                                                         |
| attributes           | assigned_to                         | object    | User assigned to the case.                                                                                                                                                                                                                                                                                                       |
| assigned_to          | data [*required*]                   | object    | Relationship to user object.                                                                                                                                                                                                                                                                                                     |
| data                 | id [*required*]                     | string    | A unique identifier that represents the user.                                                                                                                                                                                                                                                                                    |
| data                 | type [*required*]                   | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                                                                             |
| attributes           | attributes                          | object    | Custom attributes associated with the case as key-value pairs where values are string arrays.                                                                                                                                                                                                                                    |
| additionalProperties | <any-key>                           | [string]  |                                                                                                                                                                                                                                                                                                                                  |
| attributes           | closed_at                           | date-time | Timestamp of when the case was closed.                                                                                                                                                                                                                                                                                           |
| attributes           | created_at                          | date-time | Timestamp of when the case was created.                                                                                                                                                                                                                                                                                          |
| attributes           | creation_source                     | string    | Source of the case creation.                                                                                                                                                                                                                                                                                                     |
| attributes           | description                         | string    | Description of the case.                                                                                                                                                                                                                                                                                                         |
| attributes           | due_date                            | string    | Due date of the case.                                                                                                                                                                                                                                                                                                            |
| attributes           | insights                            | [object]  | Insights of the case.                                                                                                                                                                                                                                                                                                            |
| insights             | ref                                 | string    | Reference of the insight.                                                                                                                                                                                                                                                                                                        |
| insights             | resource_id                         | string    | Unique identifier of the resource. For example, the unique identifier of a security finding.                                                                                                                                                                                                                                     |
| insights             | type                                | string    | Type of the resource. For example, the type of a security finding is "SECURITY_FINDING".                                                                                                                                                                                                                                         |
| attributes           | jira_issue                          | object    | Jira issue associated with the case.                                                                                                                                                                                                                                                                                             |
| jira_issue           | error_message                       | string    | Error message if the Jira issue creation failed.                                                                                                                                                                                                                                                                                 |
| jira_issue           | result                              | object    | Result of the Jira issue creation.                                                                                                                                                                                                                                                                                               |
| result               | account_id                          | string    | Account ID of the Jira issue.                                                                                                                                                                                                                                                                                                    |
| result               | issue_id                            | string    | Unique identifier of the Jira issue.                                                                                                                                                                                                                                                                                             |
| result               | issue_key                           | string    | Key of the Jira issue.                                                                                                                                                                                                                                                                                                           |
| result               | issue_url                           | string    | URL of the Jira issue.                                                                                                                                                                                                                                                                                                           |
| jira_issue           | status                              | string    | Status of the Jira issue creation. Can be "COMPLETED" if the Jira issue was created successfully, or "FAILED" if the Jira issue creation failed.                                                                                                                                                                                 |
| attributes           | key                                 | string    | Key of the case.                                                                                                                                                                                                                                                                                                                 |
| attributes           | linear_issue                        | object    | Linear issue associated with the case.                                                                                                                                                                                                                                                                                           |
| linear_issue         | error_message                       | string    | Error message if the Linear issue creation failed.                                                                                                                                                                                                                                                                               |
| linear_issue         | result                              | object    | Result of the Linear issue creation.                                                                                                                                                                                                                                                                                             |
| result               | account_id                          | string    | Account ID of the Linear workspace.                                                                                                                                                                                                                                                                                              |
| result               | issue_id                            | string    | Unique identifier of the Linear issue.                                                                                                                                                                                                                                                                                           |
| result               | issue_key                           | string    | Key of the Linear issue.                                                                                                                                                                                                                                                                                                         |
| result               | team_id                             | string    | Team ID of the Linear issue.                                                                                                                                                                                                                                                                                                     |
| result               | url                                 | string    | URL of the Linear issue.                                                                                                                                                                                                                                                                                                         |
| linear_issue         | status                              | string    | Status of the Linear issue creation. Can be "COMPLETED" if the Linear issue was created successfully, or "FAILED" if the Linear issue creation failed.                                                                                                                                                                           |
| attributes           | modified_at                         | date-time | Timestamp of when the case was last modified.                                                                                                                                                                                                                                                                                    |
| attributes           | priority                            | string    | Priority of the case.                                                                                                                                                                                                                                                                                                            |
| attributes           | servicenow_ticket                   | object    | ServiceNow ticket associated with the case.                                                                                                                                                                                                                                                                                      |
| servicenow_ticket    | result                              | object    | Result of the ServiceNow ticket creation or attachment.                                                                                                                                                                                                                                                                          |
| result               | instance_name                       | string    | ServiceNow instance name extracted from the ticket URL.                                                                                                                                                                                                                                                                          |
| result               | sys_id                              | string    | Unique identifier of the ServiceNow incident record.                                                                                                                                                                                                                                                                             |
| result               | sys_target_link                     | string    | Direct link to the ServiceNow incident record.                                                                                                                                                                                                                                                                                   |
| result               | sys_target_sys_id                   | string    | Unique identifier of the target ServiceNow record.                                                                                                                                                                                                                                                                               |
| result               | table_name                          | string    | ServiceNow table containing the incident record.                                                                                                                                                                                                                                                                                 |
| result               | url                                 | string    | URL of the ServiceNow incident record.                                                                                                                                                                                                                                                                                           |
| servicenow_ticket    | status                              | string    | Status of the ServiceNow ticket operation. Can be "COMPLETED" if successful, or "FAILED" if the operation failed.                                                                                                                                                                                                                |
| attributes           | status                              | string    | Status of the case.                                                                                                                                                                                                                                                                                                              |
| attributes           | status_group                        | string    | Status group of the case.                                                                                                                                                                                                                                                                                                        |
| attributes           | status_name                         | string    | Status name of the case.                                                                                                                                                                                                                                                                                                         |
| attributes           | title                               | string    | Title of the case.                                                                                                                                                                                                                                                                                                               |
| attributes           | type                                | string    | Type of the case. For security cases, this is always "SECURITY".                                                                                                                                                                                                                                                                 |
| included             | id                                  | string    | Unique identifier of the case.                                                                                                                                                                                                                                                                                                   |
| included             | relationships                       | object    | Relationships of the case.                                                                                                                                                                                                                                                                                                       |
| relationships        | created_by                          | object    | User who created the case.                                                                                                                                                                                                                                                                                                       |
| created_by           | data [*required*]                   | object    | Relationship to user object.                                                                                                                                                                                                                                                                                                     |
| data                 | id [*required*]                     | string    | A unique identifier that represents the user.                                                                                                                                                                                                                                                                                    |
| data                 | type [*required*]                   | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                                                                             |
| relationships        | modified_by                         | object    | User who last modified the case.                                                                                                                                                                                                                                                                                                 |
| modified_by          | data [*required*]                   | object    | Relationship to user object.                                                                                                                                                                                                                                                                                                     |
| data                 | id [*required*]                     | string    | A unique identifier that represents the user.                                                                                                                                                                                                                                                                                    |
| data                 | type [*required*]                   | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                                                                             |
| relationships        | project                             | object    | Project in which the case was created.                                                                                                                                                                                                                                                                                           |
| project              | data [*required*]                   | object    | Data object representing a case management project.                                                                                                                                                                                                                                                                              |
| data                 | id [*required*]                     | string    | Unique identifier of the case management project.                                                                                                                                                                                                                                                                                |
| data                 | type [*required*]                   | enum      | Projects resource type. Allowed enum values: `projects`. Default: `projects`.                                                                                                                                                                                                                                                    |
| included             | type [*required*]                   | enum      | Cases resource type. Allowed enum values: `cases`. Default: `cases`.                                                                                                                                                                                                                                                             |
|                      | meta [*required*]                   | object    | Metadata of the search.                                                                                                                                                                                                                                                                                                          |
| meta                 | page [*required*]                   | object    | Pagination of the search.                                                                                                                                                                                                                                                                                                        |
| page                 | number [*required*]                 | int64     | Page number, starting at 1.                                                                                                                                                                                                                                                                                                      |
| page                 | size [*required*]                   | int64     | Page size.                                                                                                                                                                                                                                                                                                                       |
| page                 | total_filtered_count [*required*]   | int64     | Number of groups that match the search across all pages.                                                                                                                                                                                                                                                                         |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": [
    {
      "attributes": {
        "findings": {
          "by_severity": {
            "critical": 2,
            "high": 5,
            "info": 0,
            "low": 1,
            "medium": 4,
            "none": 0,
            "unknown": 0
          },
          "total": 12
        },
        "grouping_definition_id": "sca.package_update",
        "image_update": {
          "action": "alpine",
          "advisory_count": 25,
          "exploitable_cve_count": 2,
          "file_count": 1,
          "grouping_location": "Dockerfile",
          "location_is_filename": true,
          "remediation_kind": "image_update",
          "target_version": "3.20.3"
        },
        "package_update": {
          "advisory_count": 3,
          "ecosystem": "npm",
          "exploitable_cve_count": 1,
          "file_count": 2,
          "package_name": "lodash",
          "repository_id": "github.com/acme/api",
          "target_version": "4.17.21"
        },
        "title": "Update lodash to 4.17.21 in github.com/acme/api"
      },
      "id": "sca.package_update:eyJlY29zeXN0ZW0iOiJucG0iLCJyZWNvbW1lbmRlZF9uYW1lIjoibG9kYXNoIiwicmVwb3NpdG9yeV9pZCI6ImdpdGh1Yi5jb20vYWNtZS9hcGkifQ",
      "relationships": {
        "case": {
          "data": {
            "id": "c1234567-89ab-cdef-0123-456789abcdef",
            "type": "cases"
          }
        }
      },
      "type": "remediation_groups"
    }
  ],
  "included": [
    {
      "attributes": {
        "archived_at": "2025-01-01T00:00:00.000Z",
        "assigned_to": {
          "data": {
            "id": "00000000-0000-0000-2345-000000000000",
            "type": "users"
          }
        },
        "attributes": {
          "<any-key>": []
        },
        "closed_at": "2025-01-01T00:00:00.000Z",
        "created_at": "2025-01-01T00:00:00.000Z",
        "creation_source": "CS_SECURITY_FINDING",
        "description": "A description of the case.",
        "due_date": "2025-01-01",
        "insights": [
          {
            "ref": "/security/appsec/vm/library/vulnerability/dfa027f7c037b2f77159adc027fecb56?detection=static",
            "resource_id": "ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw==",
            "type": "SECURITY_FINDING"
          }
        ],
        "jira_issue": {
          "error_message": "{\"errorMessages\":[\"An error occured.\"],\"errors\":{}}",
          "result": {
            "account_id": "463a8631-680e-455c-bfd3-3ed04d326eb7",
            "issue_id": "2871276",
            "issue_key": "PROJ-123",
            "issue_url": "https://domain.atlassian.net/browse/PROJ-123"
          },
          "status": "COMPLETED"
        },
        "key": "PROJ-123",
        "linear_issue": {
          "error_message": "Linear issue creation failed.",
          "result": {
            "account_id": "463a8631-680e-455c-bfd3-3ed04d326eb7",
            "issue_id": "9c1e5f8a-2b3d-4c7e-8f6a-1d2e3f4a5b6c",
            "issue_key": "ENG-123",
            "team_id": "b5d3c8a1-7e6f-4d2c-9a8b-3c4d5e6f7a8b",
            "url": "https://linear.app/your-workspace/issue/ENG-123"
          },
          "status": "COMPLETED"
        },
        "modified_at": "2025-01-01T00:00:00.000Z",
        "priority": "P4",
        "servicenow_ticket": {
          "result": {
            "instance_name": "example",
            "sys_id": "abcdef0123456789abcdef0123456789",
            "sys_target_link": "https://example.service-now.com/incident.do?sys_id=abcdef0123456789abcdef0123456789",
            "sys_target_sys_id": "abcdef0123456789abcdef0123456789",
            "table_name": "incident",
            "url": "https://example.service-now.com/now/nav/ui/classic/params/target/incident.do?sys_id=abcdef0123456789abcdef0123456789"
          },
          "status": "COMPLETED"
        },
        "status": "OPEN",
        "status_group": "SG_OPEN",
        "status_name": "Open",
        "title": "A title for the case.",
        "type": "SECURITY"
      },
      "id": "c1234567-89ab-cdef-0123-456789abcdef",
      "relationships": {
        "created_by": {
          "data": {
            "id": "00000000-0000-0000-2345-000000000000",
            "type": "users"
          }
        },
        "modified_by": {
          "data": {
            "id": "00000000-0000-0000-2345-000000000000",
            "type": "users"
          }
        },
        "project": {
          "data": {
            "id": "aeadc05e-98a8-11ec-ac2c-da7ad0900001",
            "type": "projects"
          }
        }
      },
      "type": "cases"
    }
  ],
  "meta": {
    "page": {
      "number": 1,
      "size": 50,
      "total_filtered_count": 134
    }
  }
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="400" %}
Bad Request

{% tabs %}
{% tab label="Model" %}
API error response.

| Parent field | Field               | Type     | Description                                                                     |
| ------------ | ------------------- | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | code                | string   | An application-specific error code.                                             |
| errors       | detail              | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                | object   | Non-standard meta-information about the error                                   |
| errors       | source              | object   | References to the source of the error.                                          |
| source       | header              | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter           | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer             | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status              | string   | Status code of the response.                                                    |
| errors       | title               | string   | Short human-readable summary of the error.                                      |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    {
      "code": "invalid_request",
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="401" %}
Unauthorized

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="403" %}
Forbidden

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="429" %}
Too many requests

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}
{% /tabs %}

### Code Example

{% tabs %}
{% tab label="Curl" %}
```bash
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/security/remediation_groups" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
```
{% /tab %}
{% /tabs %}
