UPuptimerobot
Monitors

Get aggregated uptime statistics

Changed on

Returns aggregated uptime statistics across all monitors for the specified timeframe, including a logs array of incident entries.

get/monitors/uptime-stats

Request

  • Base URL
    https://api.uptimerobot.com/v3
  • URL
    https://api.uptimerobot.com/v3/monitors/uptime-stats
  • Auth
    HTTP bearer

Query parameters

logLimitnumber
Example:50

Maximum number of log entries to return (1-500).

timeFrame'DAY' | 'WEEK' | 'MONTH' | 'DAYS_30' | 'YEAR' | 'ALL' | 'CUSTOM' required

Timeframe for statistics. Use CUSTOM with start/end for custom range.

startnumber

Start timestamp (Unix seconds). Required when timeFrame=CUSTOM.

endnumber

End timestamp (Unix seconds). Required when timeFrame=CUSTOM. Must be > start.

Response

overallUptimenumber required
totalIncidentsnumber required
totalTimeWithoutIncidentsnumber required
affectedMonitorsnumber required
mtbfnumber nullable required

Changes

  • 191b37343aa3Revision changes
    • warning

      added the new 027-016 enum value to the response property for the response status

  • 8c686e2fe60aRevision changes
    • warning

      added the new 004-048 enum value to the response property for the response status

    • warning

      added the new 011-034 enum value to the response property for the response status

    • warning

      added the new 031-001 enum value to the response property for the response status

    • warning

      added the new 031-002 enum value to the response property for the response status

    • warning

      added the new 031-003 enum value to the response property for the response status

    • warning

      added the new 031-004 enum value to the response property for the response status

    • warning

      added the new 031-005 enum value to the response property for the response status