MonitorsSmtp monitors
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 bynew Date(date))startDate(string, optional)endDate(string, optional)granularity(string, optional)rawdisables aggregation,aggregatedforces it. Default: raw up to 48 hours.
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:
smtpMonitorIdmonitorlatestCheckuptimeStatsuptimeStatsMetamonitoringDataincidentsalertstestResultLogmaintenance
Example (truncated):
{
"smtpMonitorId": 200,
"monitor": {
"id": 200,
"customerId": 10,
"name": "Outbound SMTP",
"hostname": "smtp.deinkunde.com",
"port": 587,
"status": "active",
"checkInterval": 60,
"timeoutSeconds": 30,
"allowedCheckCountryCodes": ["DE"],
"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": []
}
}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
400Invalid SMTP monitor public ID (UUID)401Unauthorized403Forbidden404Not found500Failed to fetch SMTP monitor details
Common Errors
400 Bad Request(invalidRequestBody) ifrangeis notday/week/month/year,date/startDate/endDateis not a date, only one ofstartDate/endDateis given,tzis not an integer, orgranularityis notraw/aggregated