Monitors

Get monitor uptime statistics

Changed on

Returns uptime statistics for a specific monitor within a configurable date range. Defaults to the last 24 hours. Maximum range is 90 days.

get/monitors/{id}/stats/uptime

Request

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

Path parameters

idnumber required

The monitor ID

Query parameters

fromstring
Example:2025-01-01T00:00:00Z

Start date for statistics (ISO 8601 format). Defaults to 24 hours ago.

tostring
Example:2025-01-07T00:00:00Z

End date for statistics (ISO 8601 format). Defaults to now.

Response

uptimenumber required

Uptime percentage (0-100)

total_downtime_secondsnumber required

Total downtime duration in seconds

incident_countnumber required

Number of incidents in the period

mtbfnumber nullable required

Mean Time Between Failures in seconds, or null if no incidents occurred

fromstring required

Start of the date range (ISO 8601)

tostring required

End of the date range (ISO 8601)

Changes

    • warning

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

    • 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