Get SMTP Monitor Incident History
Returns incidents for a single SMTP monitor (latest 100), including a computed duration.
GET /api/smtp-monitors/:smtpMonitorPublicId/incident-history
Authentication
Requires a valid session.
- Header:
Authorization: Bearer <token>
Parameters
smtpMonitorPublicId(Path, required): SMTP 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):open,acknowledged, orresolved.type(string, optional):downtime,http_status,ssl_expiry,ssl_critical,ssl_warning,response_time,dnsbl,domain_expiry_warning,critical, orinconclusive.from/to(ISO date string, optional): Filter bystartedAtrange.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/smtp-monitors/11111111-1111-4111-8111-111111111111/incident-history?envelope=items" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Example Response
{
"items": [
{
"id": 123,
"publicId": "55555555-5555-4555-8555-555555555555",
"type": "downtime",
"status": "resolved",
"startedAt": "2026-02-26T12:10:00.000Z",
"endedAt": "2026-02-26T12:12:30.000Z",
"durationMs": 150000,
"statusCode": null,
"errorMessage": "connect ETIMEDOUT",
"details": "connect ETIMEDOUT",
"isOngoing": false
}
],
"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.
Deprecated field: duration (text, e.g. 2m 30s) is still sent next to durationMs until it is removed on 2027-01-18. Read durationMs.
status is open, acknowledged, or resolved. Ongoing incidents have a null endedAt and isOngoing: true.
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 SMTP monitor public ID (UUID) requiredif:smtpMonitorPublicIdis invalid400 Bad Request(invalidRequestBody) if a query parameter is invalid:page/limitnot a positive integer,formatnotjson/csv,downloadnot0/1, or an unknown value instatusortype400 Bad Request(invalidDateRange) iffromortois not a date401 Unauthorizedif you are not authenticated403 Forbiddenif you do not have access to the monitor