MonitorsImap pop monitors
Get IMAP/POP Monitor Details
Consolidated endpoint that returns the IMAP/POP monitor detail page payload in a single call (latest check, uptime stats, incidents, alert history, maintenance windows, chart data, etc.).
GET /api/imap-pop-monitors/:imapPopMonitorPublicId/details
Authentication
Requires a valid session.
- Header:
Authorization: Bearer <token>
Parameters
imapPopMonitorPublicId(Path, required): IMAP/POP monitor public UUID.range(Query, optional):day|week|month|year(default:day).date(Query, optional): Reference date as ISO string.startDate(Query, optional): Override start date as ISO string.endDate(Query, optional): Override end date as ISO string.granularity(Query, optional): If set and notraw, the backend may aggregate monitoring chart data.
cURL
curl -X GET "https://YOUR_DOMAIN/api/imap-pop-monitors/66666666-6666-4666-8666-666666666666/details?range=day" \
-H "Authorization: Bearer $TOKEN"Response
The response is a large object. Key top-level fields:
imapPopMonitorIdmonitorlatestCheckuptimeStats,uptimeStatsMetamonitoringDataincidentsalertstestResultLogmaintenance
Example (truncated):
{
"imapPopMonitorId": 500,
"monitor": { "id": 500, "hostname": "mail.deinkunde.com", "status": "active" },
"latestCheck": { "id": 123, "status": "success", "checkedAt": "2026-02-26T12:00:00.000Z" },
"uptimeStats": {
"day": "100.00",
"month": "100.00",
"year": "100.00",
"dayAvgResponse": 142,
"monthAvgResponse": 150,
"yearAvgResponse": 160
},
"maintenance": {
"inMaintenance": false,
"activeWindows": [],
"allWindows": []
}
}Data retention
Single checks are kept for 24 hours, minute aggregates for 30 days and daily aggregates for 24 months; a range older than 30 days returns one point per day. If the monitor has no check within the last 24 hours, latestCheck describes its last minute from the aggregate: id starts with 1min-, resolution is 1min, and locationId and errorMessage are null.
Errors
400Invalid IMAP/POP monitor public ID (UUID)401Unauthorized403Forbidden404IMAP/POP monitor not found500Failed to fetch IMAP/POP monitor details
Common Errors
400 Bad Request(invalidRequestBody) ifrangeis notday/week/month/year,date/startDate/endDateis not a date, only one ofstartDate/endDateis given,tzis not an integer, orgranularityis notraw/aggregated