---
title: "Retrieve a list of alerts."
method: GET
path: "/api/v1/alerts"
tags: ["Alerts"]
---

# Retrieve a list of alerts.

`GET /api/v1/alerts`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/alerts`
- Auth: HTTP bearer

Required scope: `alerts:read`

## Query parameters

- `operatorId` integer, nullable: Restrict to a sub-operator. Required when your consumer has access to more than one operator and none is implied by your credentials.
- `status` 'open' | 'acknowledged' | 'snoozed' | 'resolved', nullable: Filter by alert status.
- `lastEventFrom` string, date-time, nullable: Only include alerts with an event at or after this time.

## Response `200`

get-alerts 200 response

- OffsetBasedResponse
  - `data` Alert[], required
    - `id` string, required: Id of the alert.
    - `operatorId` integer: Id of the operator this alert belongs to.
    - `type` string, required: The aggregated issue-type token this alert groups.
    - `scope` AlertScope, required: What an alert or issue is about.
      - `type` 'operator' | 'site' | 'charge-point' | 'unknown', required: The kind of entity this alert or issue is scoped to.
      - `id` string, required: Id of the scoped entity.
    - `status` 'open' | 'acknowledged' | 'snoozed' | 'resolved' | 'unknown', required: Current status of the alert.
    - `title` string, nullable: Human label for the alert, if set.
    - `triggerReason` string, nullable: Human-readable explanation for why this alert was raised, if set.
    - `issueCount` integer: Number of issues currently attached to this alert.
    - `eventCount` integer: Total events across every attached issue.
    - `chargePointCount` integer: Number of distinct charge points across every attached issue.
    - `firstEventAt` string, date-time, nullable: Earliest event across every attached issue, if any.
    - `lastEventAt` string, date-time, nullable: Most recent event across every attached issue, if any.
    - `isManual` boolean: Whether this alert was created by hand rather than by the alerting engine.
    - `snoozedUntil` string, date-time, nullable: When a `snoozed` alert automatically re-opens, if set.
    - `eventFrequency` AlertEventFrequencyBucket[], nullable: Day-bucketed event counts across every attached issue.
      - `start` string, date-time, required: Start of the day bucket (UTC).
      - `count` integer: Number of events in this bucket.
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/alerts/get.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)