Incidents

List incidents

Returns incidents for the authenticated account with optional filtering and pagination. Ordered by start time (newest first). A resolved incident older than 30 days is never returned here (issue #357) — this is a visibility floor enforced at read time, independent of how long the underlying row is physically kept (95 days, so the uptime-report worker and a status page's 90-day daily history both have enough lookback; see internal/retention/DECISIONS.md). An open incident is never hidden by this floor, however old it is.

get/api/v1/incidents

Request

  • Base URL: https://api.uptimemonitoring.com
  • URL: https://api.uptimemonitoring.com/api/v1/incidents
  • Auth: HTTP bearer

Query parameters

monitor_idinteger

Filter by monitor ID.

type'down' | 'flapping'

Filter by incident type.

started_afterstring date-time

Only incidents started after this time (RFC3339).

started_beforestring date-time

Only incidents started before this time (RFC3339).

limitinteger

Page size (1-100).

offsetinteger

Number of items to skip.

Response

Paginated incident list.

totalinteger

Total matching incidents (for pagination).

limitinteger
offsetinteger

Changes

No recorded changes to this operation across all 1 revision of this API.