Uptimeify Docs
MonitorsSmtp monitors

Get SMTP Monitor Check History

Returns recent check results for an SMTP monitor.

GET /api/smtp-monitors/:smtpMonitorPublicId/check-history

Authentication

Requires a valid session.

  • Header: Authorization: Bearer <token>

Parameters

  • smtpMonitorPublicId (Path, required): SMTP monitor public UUID.

Query Parameters

  • limit (number, optional)
    • Default: 50
    • Max: 200

cURL

curl "https://YOUR_DOMAIN/api/smtp-monitors/33333333-3333-4333-8333-333333333333/check-history?limit=50" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "data": [
    {
      "id": 12345,
      "status": "success",
      "errorMessage": null,
      "warningMessage": null,
      "timingSmtp": 123,
      "diagnostics": {
        "raw": "optional diagnostic payload"
      },
      "checkedAt": "2026-01-01T12:00:00.000Z",
      "locationId": 1,
      "locationName": "Nuremberg (DE)",
      "locationCode": "de-nbg"
    }
  ]
}

Errors

  • 400 SMTP monitor public ID (UUID) required
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not found

On this page