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.example.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": []
  }
}

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

On this page