Get SMTP Monitor Alert History

Returns notification/escalation attempts (alert history) for incidents of a SMTP monitor.

GET /api/smtp-monitors/:smtpMonitorPublicId/alert-history

Authentication

Requires a valid session.

Header: Authorization: Bearer <token>

Parameters

smtpMonitorPublicId (Path, required): SMTP monitor public UUID.

Example (cURL)

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

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

Example Response

{
  "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 SMTP monitor public ID (UUID) required if :smtpMonitorPublicId is invalid
401 Unauthorized if you are not authenticated
403 Forbidden if you do not have access to the monitor