---
title: "Get an alert"
method: GET
path: "/alerts/{id}"
tags: ["alert"]
---

# Get an alert

`GET /alerts/{id}`

## Path parameters

- `id` string, required — ID of the alert

## Response `200`

OK response.

- AlertAPIAlert
  - `assignee` object — The Actor that is assigned to this alert
    - `id` 'user' | 'api-token' | 'system'
    - `type` string
  - `context` unknown
  - `contextTags` string[] — the context tags for the alert
  - `createdAt` string — Date and time when the alert got created
  - `deliveries` AlertAPIDelivery[] — The metadata around the alert's delivery attempts
    - `dispatchedAt` string, required
    - `label` string, required — The label of the alert at where it was delivered (channel name/ID, jira ticket, asana issue, etc)
    - `message` string, required
    - `outputId` string, required
    - `statusCode` integer, required
    - `success` boolean, required
  - `detection` AlertAPIDetectionInfo
    - `id` string — The unique identifier of this Detection
    - `type` 'RULE' | 'CORRELATION_RULE' | 'POLICY' | 'SCHEDULED_RULE' — The type of this Detection
  - `eventCount` integer — The number of events that have been received for this alert
  - `firstEventOccurredAt` string — Date and time of this alert's first event
  - `id` string, required — The unique identifier of this alert
  - `lastReceivedEventAt` string — Date and time that the last event related to this alert was received
  - `quality` 'NOISE' | 'USEFUL' — The quality of this Alert
  - `runbook` string — The runbook for this Alert, as extracted from its origin
  - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' | 'INFO' — The severity of this Alert
  - `status` 'OPEN' | 'CLOSED' | 'TRIAGED' | 'RESOLVED', required — The status of this Alert
  - `systemError` AlertAPISystemError
    - `detection` AlertAPIDetectionInfo
      - `id` string — The unique identifier of this Detection
      - `type` 'RULE' | 'CORRELATION_RULE' | 'POLICY' | 'SCHEDULED_RULE' — The type of this Detection
    - `sourceId` string — The source ID of this SystemError
    - `sourceType` string — The source type of this SystemError
    - `type` string — The type of this SystemError
  - `title` string — The title of this alert
  - `type` string, required — The type of this alert
  - `updatedBy` object — The Actor that last updated the state of this alert
    - `id` 'user' | 'api-token' | 'system'
    - `type` string

## Other responses

- `400` — bad_request: Bad Request response.
- `404` — not_found: Not Found response.

---

[API](https://skmtc.dev/panther/apis/panther-rest-api.md) · [All operations](https://skmtc.dev/panther/apis/panther-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panther/panther-rest-api/revisions/eb177cb9d6a1/schema)