---
title: "List passive health check alerts"
method: GET
path: "/compute/passive_health_check_alerts"
tags: ["HealthCheckService"]
---

# List passive health check alerts

`GET /compute/passive_health_check_alerts`

Lists passive health check alerts. Filters combine across axes; empty values skip that axis.

## Query parameters

- `intent_id` string — Remediation intent ID to filter by.
- `instance_id` string — Instance ID to filter by.
- `cluster_id` string — Optional instance cluster ID to filter by. Required for non-admin callers.
- `page_size` integer — Max number of results to return.
- `page_token` string — Opaque pagination token from the previous response.
- `status` 'PHC_ALERT_STATUS_FIRING' | 'PHC_ALERT_STATUS_RESOLVED' | 'PHC_ALERT_STATUS_ALL' — Lifecycle filter. Omit to return firing alerts.
- `severity_filter` string[] — Severity tiers to include. Omit or pass an empty array to include all severities.
- `order_by` 'PHC_ALERT_ORDER_STARTED_AT_ASC' | 'PHC_ALERT_ORDER_STARTED_AT_DESC' — Sort order for returned alerts. Omit for newest alerts first.

## Response `200`

OK

- ListPassiveHealthCheckAlertsResponse — Response returned when listing passive health check alerts.
  - `alerts` PassiveHealthCheckAlert[], required — Alerts on the current page, ordered by the request sort order.
    - `passive_health_check_alert_id` string, required — Primary key UUID for the passive health check alert.
    - `instance_id` string — Resolved instance UUID. Empty until the alert is joined to an instance.
    - `cluster_id` string, required — Cluster UUID the alert was raised against.
    - `target_vm` string, required — VM name extracted from the Alertmanager labels.
    - `alert_name` string, required — Alertmanager alert name.
    - `severity` 'PHC_SEVERITY_INFO' | 'PHC_SEVERITY_WARNING' | 'PHC_SEVERITY_CRITICAL', required — Canonical severity tier for the alert.
    - `annotations` object, required — Alertmanager annotations as key-value strings.
    - `started_at` string, date-time, required — Time when the underlying alert first fired.
    - `resolved_at` string, date-time — Time when the underlying alert resolved. Empty while the alert is firing.
    - `node_remediation_intent_id` string — Remediation intent UUID attached to this alert, if any.
  - `next_page_token` string, required — Opaque token for the next page. Empty means there are no more pages.

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/92114e606090/schema)
