Get ICMP Monitor Alert History
Returns notification/escalation attempts (alert history) for incidents of a ICMP monitor.
GET /api/icmp-monitors/:icmpMonitorPublicId/alert-history
Authentication
Requires a valid session.
- Header:
Authorization: Bearer <token>
Parameters
icmpMonitorPublicId(Path, required): ICMP monitor public UUID.
Query Parameters
page(number, optional): Page number (default:1).limit(number, optional): Items per page (default:25; max100). Ignored in favor of export defaults whenformat=csvordownload=1(default10000, max50000).status(string, optional):sentorfailed.from/to(ISO date string, optional): Filter bysentAtrange.format(string, optional):json(default) orcsv.download(string, optional):1to force an attachment download,0(default) for the page.envelope(string, optional):itemsanswers as{ items, total, page, perPage }. Becomes the default on 2027-01-18.
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/icmp-monitors/11111111-1111-4111-8111-111111111111/alert-history?envelope=items" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Example Response
{
"items": [
{
"id": 987,
"incidentId": 123,
"type": "slack",
"status": "sent",
"channelName": "Ops Slack",
"channelType": "slack",
"channelConfig": null,
"sentAt": "2026-02-26T12:11:00.000Z",
"errorMessage": null
}
],
"total": 1,
"page": 1,
"perPage": 25
}List form: with envelope=items the list arrives as { items, total, page, perPage } (perPage is the limit). Without it the endpoint still answers the current form { data, total, page, pageCount }, which is deprecated; { items, ... } becomes the default on 2027-01-18.
Each entry is one delivery attempt to one notification channel. status is sent or failed (with errorMessage set on failure); channelType is the channel type (e.g. email, slack, opsgenie). channelConfig has secrets redacted.
When format=csv (or download=1), the response is a text/csv (or application/json for format=json&download=1) attachment instead of the paginated JSON list above.
Common Errors
400 ICMP monitor public ID (UUID) requiredif:icmpMonitorPublicIdis invalid400 Bad Request(invalidRequestBody) if a query parameter is invalid:page/limitnot a positive integer,formatnotjson/csv,downloadnot0/1, or an unknown value instatus400 Bad Request(invalidDateRange) iffromortois not a date401 Unauthorizedif you are not authenticated403 Forbiddenif you do not have access to the monitor