List incidents for the authenticated account. Set scope to open for all current open incidents, or recent_closed for the 12 most recently resolved incidents (newest first). Includes monitors and heartbeats.
| Method | POST |
| Url | https://downdar.com/api/v1/incidents/list |
scope
key
|
open: all open incidents. recent_closed: the 12 most recently resolved incidents, newest first. |
ok
|
Always true on success. |
scope
|
Echoes the requested scope: open or recent_closed. |
incidents
|
Array of incident summary objects. |
rate_limit
|
Rate limit state for the tier this endpoint consumes. Present on every successful response. |
guid
|
Incident id. |
status
|
open or resolved. |
started_at
|
UTC datetime when the incident opened. |
ended_at
|
null while open. UTC datetime when resolved. |
object
|
Monitor or heartbeat this incident belongs to. |
category
|
monitor or heartbeat. |
type
|
For monitors: http, ping, tcp, ssl, or dns. For heartbeats: heartbeat. |
guid
|
Monitor or heartbeat id. |
name
|
Resource name when it still exists. |
target
|
Display target (URL, host, heartbeat ping URL, etc.) when available. |
tier
|
Rate tier this endpoint counts against (1-5). |
cost
|
Units consumed by this request against the tier window. |
timeframe
|
Rolling limit window: second, minute, hour, or day. |
limit
|
Maximum units allowed in the timeframe for this tier on your plan. |
used
|
Units already used in the current window. |
remaining
|
Units left before this tier returns HTTP 429. |