Get downtime periods
get_downtimeRead-onlyIdempotent
List the outages Oh Dear recorded for a monitor, with the start and end of each one. Times are UTC. Returns the most recent outages up to the limit you set, and totals the downtime across just those, so widen the limit before drawing conclusions about a long period. See https://ohdear.app/docs/api/uptime.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of outages to return, most recent first (default: 50) | |
| monitor_id | Yes | The ID of the monitor to list downtime for | |
| ended_before | No | Only return outages that ended on or before this moment, as YmdHis (20241231235959) or ISO 8601 | |
| started_after | No | Only return outages that started on or after this moment, as YmdHis (20241201120000) or ISO 8601 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter | No | Normalized date filters applied to this result. | |
| monitor | Yes | ||
| view_url | Yes | ||
| downtime_periods | Yes | Recorded downtime periods. | |
| downtime_periods_count | Yes | ||
| total_downtime_in_seconds | Yes |