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
- Default:
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
400SMTP monitor public ID (UUID) required401Unauthorized403Forbidden404Not found