Skip to Content
Uptimeify Docs
Organization smtp

Get SMTP Send Logs

Returns recent SMTP send event logs from Redis. Admin-only.

GET /api/organization/smtp/logs

Query Parameters

ParameterTypeDefaultDescription
limitnumber100Max events to return (1-500)
envelopestringnoneitems: answer as { items, total, page, perPage }. Becomes the default on 2027-01-18.

Example (cURL)

curl -X GET "$BASE_URL/api/organization/smtp/logs?limit=50&envelope=items" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Accept: application/json"

Response

{
  "items": [
    {
      "type": "smtp_send",
      "timestamp": "2026-04-15T12:00:00.000Z",
      "to": "admin@deinkunde.com",
      "subject": "Website Down: deinkunde.com",
      "status": "sent"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 1
}

List form: with envelope=items the list arrives as { items, total, page, perPage }. Without it the endpoint still answers the current form ({ "events": [...] }), which is deprecated; { items, ... } becomes the default on 2027-01-18.

Returns an empty list ("items": []; in the current form { "events": [] }) if no logs exist or on Redis errors (fails open).

Common errors

  • 401 Unauthorized when not authenticated
  • 403 Forbidden when not an admin

On this page