---
title: "List Agent Health issues"
method: GET
path: "/api/v2/agenthealth/issues"
tags: ["Agent Health"]
---

# List Agent Health issues

`GET /api/v2/agenthealth/issues`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/agenthealth/issues`
- 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: `hosts_read`

List Agent Health issues across your organization. Only open issues are returned.
Returns `403` if you lack the `hosts_read` permission.

Results use a stable order: severity rank (`high`, `medium`, `low`, then other values),
then `first_seen_at` descending with missing timestamps last, then issue ID ascending.
Use `page[size]` and the zero-based `page[number]` to paginate. Invalid page values
return a `400` JSON:API error response. `meta.page.total_filtered_count` is the number
of issues matching the filters, and `meta.page.total_count` the number of open issues
in the organization.

Each filter accepts up to 50 comma-separated exact values of at most 256 characters
each, combined with OR within a filter and AND across filters. Blank entries are ignored; an all-blank filter
is treated as absent.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter[severity]` string
- `filter[category]` string
- `filter[issue_type]` string
- `filter[resource_kind]` string
- `filter[resource_id]` string

## Response `200`

OK

- AgentHealthIssuesResponse: A paginated response containing open Agent Health issues.
  - `data` AgentHealthIssueData[], required: The open Agent Health issues on this page.
    - `attributes` AgentHealthIssueAttributes, required: Attributes of an open Agent Health issue.
      - `category` string: The category of the issue, such as `configuration`. Omitted when not set.
      - `description` string: The description of the issue. Omitted when empty.
      - `first_seen_at` string, date-time: The time the issue was first seen, in RFC 3339 format. Omitted when empty.
      - `issue_name` string, required: The human-readable name of the issue.
      - `issue_type` string, required: The machine-readable type of the issue.
      - `resource_id` string, required: The identifier of the affected resource, interpreted according to `resource_kind`: hostname for `host`, DaemonSet UID for `deployment` (node Agent), cluster UUID for `cluster`, hostname of the host running the Cluster Agent for `cluster_agent`, or OpenTelemetry collector ID for `otel`.
      - `resource_kind` string, required: The kind of affected resource. Known values are `host`, `deployment`, `cluster`, `cluster_agent`, and `otel`.
      - `resource_type` string: The type of the affected resource. Omitted when empty.
      - `severity` string, required: The severity of the issue. Known values are `low`, `medium`, `high`, and `unknown`.
      - `state` string, required: The state of the issue. Only issues with state `open` are returned.
      - `tags` string[]: Tags associated with the issue. Omitted when empty.
      - `title` string: The title of the issue. Omitted when empty.
      - `updated_at` string, date-time: The time the issue was last updated, in RFC 3339 format. Omitted when empty.
    - `id` string, required: The unique identifier of the issue.
    - `type` 'agent_health_issues', required: The Agent Health issue resource type.
  - `meta` AgentHealthIssuesResponseMeta, required: Pagination metadata for the matching Agent Health issues.
    - `page` AgentHealthIssuesResponsePage, required: Pagination counts for the Agent Health issues.
      - `total_count` integer, required: The total number of open issues in the organization, ignoring filters.
      - `total_filtered_count` integer, required: The total number of open issues matching the filters, across all pages.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests

## Changes

- **2026-11-12** `f63873c73fb1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/agenthealth/issues/get.md)

---

[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/14d85160bfa9?raw)
