---
title: "To retrieve the list of alarms for a site"
method: GET
path: "/api/v4/systems/{system_id}/alarms"
tags: ["System Details"]
---

# To retrieve the list of alarms for a site

`GET /api/v4/systems/{system_id}/alarms`

## Request

- Base URL: `https://api-qa2.enphaseenergy.com`
- URL: `https://api-qa2.enphaseenergy.com/api/v4/systems/{system_id}/alarms`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enphase/apis/monitoring-api/docs/api/v4/systems/:system_id/alarms/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is used to retrieve the alarms for a site. start_time is mandatory and cannot be older than 9 months from the current time.  Maximum 1 week of data can be retrieved in a single call.

Many event types (though not all) come with predefined escalation criteria for alarms. When an event meets these configurations, it can trigger an alarm. For example, a common configuration might specify that an event should trigger an alarm if its status remains “Open” beyond a certain time threshold.

An Alarm is always tied to an Event, and the relationship between them can be one-to-one or one-to-many. For instance, if a site has a single battery and its State of Charge (SOC) drops below a predefined threshold, an event is created. If the SOC remains below that threshold for a specified duration, an alarm is triggered for that battery. In another scenario, if a site has multiple batteries and all of them fall below the SOC threshold, individual events are created for each battery. If the low SOC condition persists across all batteries for the defined time period, a single alarm may be triggered for all of them.

This means:

- An alarm can be associated with multiple events.

- But an event can be associated with only one alarm.

## Path parameters

- `system_id` integer, required

## Query parameters

- `start_time` integer, required
- `end_time` integer
- `cleared` boolean

## Response `200`

List of alarms

- object
  - `system_id` integer: The unique numeric ID of the system.
  - `alarms` object: List of alarms

## Other responses

- `401`: Authentication Error
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `501`: Not Implemented

## Changes

- **2026-11-06** `a783ff728669`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/enphase/apis/monitoring-api/changes/api/v4/systems/:system_id/alarms/get.md)

---

[API](https://skmtc.dev/enphase/apis/monitoring-api.md) - [All operations](https://skmtc.dev/enphase/apis/monitoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enphase/apis/monitoring-api/revisions/a783ff728669?raw)