Get SMTP Monitor Details

Consolidated endpoint that returns the SMTP monitor details page data in one call.

GET /api/smtp-monitors/:smtpMonitorPublicId/details

Authentication

Requires a valid session.

Header: Authorization: Bearer <token>

Parameters

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

Query Parameters

range (string, optional): day, week, month, year (default: day)
date (string, optional): Reference date (parsed by new Date(date))
startDate (string, optional)
endDate (string, optional)
granularity (string, optional)
- If set to raw, disables aggregation.

cURL

curl "https://YOUR_DOMAIN/api/smtp-monitors/33333333-3333-4333-8333-333333333333/details?range=day" \
  -H "Authorization: Bearer $TOKEN"

Response

The response is a single object with these top-level keys:

smtpMonitorId
monitor
latestCheck
uptimeStats
uptimeStatsMeta
monitoringData
incidents
alerts
testResultLog
maintenance

Example (truncated):

{
  "smtpMonitorId": 200,
  "monitor": {
    "id": 200,
    "customerId": 10,
    "name": "Outbound SMTP",
    "hostname": "smtp.example.com",
    "port": 587,
    "status": "active",
    "checkInterval": 60,
    "timeoutSeconds": 30,
    "config": {
      "secure": false,
      "requireTls": true
    }
  },
  "latestCheck": {
    "status": "success",
    "checkedAt": "2026-01-01T12:00:00.000Z",
    "timingSmtp": 123,
    "locationCode": "de-nbg",
    "locationName": "Nuremberg (DE)"
  },
  "uptimeStats": {
    "day": 99.9,
    "month": 99.5,
    "year": 99.0,
    "dayAvgResponse": 120,
    "monthAvgResponse": 140,
    "yearAvgResponse": 150
  },
  "maintenance": {
    "inMaintenance": false,
    "activeWindows": [],
    "allWindows": []
  }
}

Errors

400 Invalid SMTP monitor public ID (UUID)
401 Unauthorized
403 Forbidden
404 Not found
500 Failed to fetch SMTP monitor details