Skip to Content
Uptimeify Docs
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 not raw, 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:

  • imapPopMonitorId
  • monitor
  • latestCheck
  • uptimeStats, uptimeStatsMeta
  • monitoringData
  • incidents
  • alerts
  • testResultLog
  • maintenance

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

  • 400 Invalid IMAP/POP monitor public ID (UUID)
  • 401 Unauthorized
  • 403 Forbidden
  • 404 IMAP/POP monitor not found
  • 500 Failed to fetch IMAP/POP monitor details

Common Errors

  • 400 Bad Request (invalidRequestBody) if range is not day/week/month/year, date/startDate/endDate is not a date, only one of startDate/endDate is given, tz is not an integer, or granularity is not raw/aggregated

On this page