Skip to Content
Uptimeify Docs
MonitorsImap pop monitors

Get IMAP/POP Monitor Incident History

Returns incidents for a single IMAP/POP monitor (latest 100), including a computed duration.

GET /api/imap-pop-monitors/:imapPopMonitorPublicId/incident-history

Authentication

Requires a valid session.

  • Header: Authorization: Bearer <token>

Parameters

  • imapPopMonitorPublicId (Path, required): IMAP/POP monitor public UUID.

Query Parameters

  • page (number, optional): Page number (default: 1).
  • limit (number, optional): Items per page (default: 25; max 100). Ignored in favor of export defaults when format=csv or download=1 (default 10000, max 50000).
  • status (string, optional): open, acknowledged, or resolved.
  • type (string, optional): downtime, http_status, ssl_expiry, ssl_critical, ssl_warning, response_time, dnsbl, domain_expiry_warning, critical, or inconclusive.
  • from / to (ISO date string, optional): Filter by startedAt range.
  • format (string, optional): json (default) or csv.
  • download (string, optional): 1 to force an attachment download, 0 (default) for the page.
  • envelope (string, optional): items answers 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/imap-pop-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 IMAP/POP monitor public ID (UUID) required if :imapPopMonitorPublicId is invalid
  • 400 Bad Request (invalidRequestBody) if a query parameter is invalid: page/limit not a positive integer, format not json/csv, download not 0/1, or an unknown value in status or type
  • 400 Bad Request (invalidDateRange) if from or to is not a date
  • 401 Unauthorized if you are not authenticated
  • 403 Forbidden if you do not have access to the monitor

On this page