---
title: "Get SSH Monitor Alert History"
description: "Returns notification/escalation attempts (alert history) for incidents of a SSH monitor."
---

`GET /api/ssh-monitors/:sshMonitorPublicId/alert-history`

## Authentication

Requires a valid session.

- Header: `Authorization: Bearer <token>`

## Parameters

- `sshMonitorPublicId` (Path, required): SSH monitor public UUID.

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET "$BASE_URL/api/ssh-monitors/11111111-1111-4111-8111-111111111111/alert-history" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Example Response

```json
{
  "alerts": [
    {
      "id": 987,
      "incidentId": 123,
      "type": "slack",
      "status": "sent",
      "channelName": "Ops Slack",
      "sentAt": "2026-02-26T12:11:00.000Z",
      "errorMessage": null
    }
  ],
  "total": 1
}
```

Each entry is one delivery attempt to one notification channel. `status` is `sent` or `failed` (with `errorMessage` set on failure); `type` is the channel type (e.g. `email`, `slack`, `opsgenie`).

## Common Errors

- `400 SSH monitor public ID (UUID) required` if `:sshMonitorPublicId` is invalid
- `401 Unauthorized` if you are not authenticated
- `403 Forbidden` if you do not have access to the monitor