---
title: "GET /v1/alert/history-alerts"
method: GET
path: "/v1/alert/history-alerts"
tags: ["Alert"]
---

# GET /v1/alert/history-alerts

`GET /v1/alert/history-alerts`

## Request

- The document declares no server URL.
- Auth: none declared

## Query parameters

- `page` integer
- `pageSize` integer
- `startAtUnix` string
- `endAtUnix` string
- `status` integer
- `strategyGroupUids` string[]
- `levelUids` string[]
- `strategyUids` string[]
- `datasourceUids` string[]
- `keyword` string

## Response `200`

OK

- MarksmanApiV1ListHistoryAlertReply
  - `total` string
  - `page` integer
  - `pageSize` integer
  - `items` MarksmanApiV1AlertEventItem[]
    - `uid` string
    - `strategyGroupUid` string
    - `strategyGroupName` string
    - `strategyUid` string
    - `strategyName` string
    - `levelUid` string
    - `levelName` string
    - `datasourceUid` string
    - `datasourceName` string
    - `summary` string
    - `description` string
    - `expr` string
    - `firedAt` string
    - `value` number, double
    - `labels` object
    - `status` integer
    - `intervenedAt` string
    - `intervenedBy` string
    - `intervenedByName` string
    - `suppressUntilAt` string
    - `suppressedBy` string
    - `suppressedByName` string
    - `suppressedReason` string
    - `recoveredAt` string
    - `recoveredBy` string
    - `recoveredByName` string
    - `recoveredReason` string
    - `bgColor` string
    - `duration` string
    - `datasourceLevelName` string

## Changes

- **2026-03-25** `650c5b44c427`: 1 info
  - added the optional property `items/items/datasourceLevelName` to the response with the `200` status
- **2026-03-25** `f450cff5eac8`: 1 info
  - the `items/items/duration` response's property pattern `^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$` was removed for the status `200`
- **2026-03-25** `830c0962802f`: 1 info
  - endpoint added
- **2026-02-28** `f5912329bb01`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/alert/history-alerts/get.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)