---
title: "This endpoint is used to list one or more occurrences for an Alert."
method: GET
path: "/api/v2/alerts/{id}/occurrences"
tags: ["Monitoring and Alerting"]
---

# This endpoint is used to list one or more occurrences for an Alert.

`GET /api/v2/alerts/{id}/occurrences`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/alerts/{id}/occurrences`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/alerts/:id/occurrences/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to list one or more occurrences for an Alert.

## Path parameters

- `id` string, byte, required

## Query parameters

- `filter` string[]
- `fields` string[]
- `skip` string, int64
- `sort` string[]
- `limit` string, int64

## Response `200`

A successful response.

- JumpcloudAlertsListAlertOccurrencesResponse: ListAlertOccurrencesResponse is the response message for ListAlertOccurrencesRequest.
  - `alertOccurrences` JumpcloudAlertsAlertOccurrence[]
    - `alertObjectId` string, byte: The Alert under which this occurrence is held.
    - `context` object: context holds the context data as specified by the generator of the alert.
    - `createdAt` string, date-time: created_at is the timestamp from the initiator of the occurrence.
    - `occurredAt` string, date-time: occurred_at is the timestamp from the initiator of the occurrence.
    - `updatedAt` string, date-time: updated_at is the timestamp when occurrence is updated.
  - `count` integer

---

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