---
title: "Retrieve a single alert."
method: GET
path: "/api/v1/alerts/{alertId}"
tags: ["Alerts"]
---

# Retrieve a single alert.

`GET /api/v1/alerts/{alertId}`

## Request

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

Required scope: `alerts:read`

## Path parameters

- `alertId` string, required

## Query parameters

- `operatorId` integer, nullable

## Response `200`

get-alert 200 response

- AlertDetail: An alert with its member issues, delivery notifications and event-source breakdown.
  - `id` string, required: Id of the alert.
  - `operatorId` integer, required
  - `type` string, required
  - `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` string, required
  - `title` string, nullable
  - `triggerReason` string, nullable
  - `issueCount` integer, required
  - `eventCount` integer, required
  - `chargePointCount` integer, required
  - `firstEventAt` string, date-time, nullable
  - `lastEventAt` string, date-time, nullable
  - `isManual` boolean, required
  - `snoozedUntil` string, date-time, nullable
  - `eventFrequency` AlertEventFrequencyBucket[], nullable
    - `start` string, date-time, required: Start of the day bucket (UTC).
    - `count` integer: Number of events in this bucket.
  - `issues` Issue[], required: Issues attached to this alert.
    - `id` string, required: Id of the issue.
    - `operatorId` integer: Id of the operator this issue belongs to.
    - `type` string, required: The issue-type token.
    - `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.
    - `teamId` string, nullable: Id of the team this issue is scoped to, when service-alerts exposes it. Null today.
    - `siteId` string, nullable: Id of the site this issue is scoped to, when service-alerts exposes it. Null today.
    - `status` 'open' | 'resolved' | 'unknown', required: Current status of the issue.
    - `eventCount` integer: Number of events attached to this issue.
    - `firstEventAt` string, date-time, nullable: Earliest event on this issue, if any.
    - `lastEventAt` string, date-time, nullable: Most recent event on this issue, if any.
    - `resolvedAt` string, date-time, nullable: When this issue was resolved, if it has been.
  - `notifications` AlertNotification[], required: Notifications (Monta workflow runs) this alert has produced.
    - `id` string, required: Id of the workflow trigger.
    - `workflowName` string, required: Name of the workflow that ran.
    - `triggeredAt` string, date-time, required: When the workflow triggered.
    - `outcome` 'sent' | 'pending' | 'filtered' | 'resolved' | 'unknown', required: Outcome of the workflow run.
    - `channels` string[], required: Channels the workflow delivered on; populated only for `sent`.
  - `sources` IssueSources, required: Sentry-style tag breakdowns aggregated over an issue's events.
    - `breakdowns` IssueSourceBreakdown[], required
      - `dimension` string, required: Stable machine key for this dimension.
      - `title` string, required: Human-readable label for this dimension.
      - `entries` IssueSourceEntry[], required
        - `label` string, required: The raw grouped value.
        - `count` integer: Number of events in this row.
        - `assetType` string, nullable: Open-vocabulary asset type, if this row denotes a Monta entity.
        - `assetId` string, nullable: Opaque id of the asset; not necessarily numeric.

## 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/:alertId/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)