Skip to content
GET/api/v1/incidentsPublicOpen in browser →

List incidents

ParameterInTypeDescription
providerquerystringFilter by provider slug. An unknown slug answers an empty result set.
severityqueryminor | major | critical | maintenanceFilter by incident severity.
statequeryactive | resolvedFilter by lifecycle state; wins over the deprecated active flag when both are sent.
activequerybooleanDeprecated alias of state: true maps to state=active, false to state=resolved.
pagequeryinteger1-based page number. Pages past the end clamp to the last page.
limitqueryinteger (1-100)Page size.

Request

curl "https://outagedeck.com/api/v1/incidents?provider=aws&state=resolved&severity=minor&limit=10"

Response (truncated)

{
  "meta": { "version": "v1", "generatedAt": "2026-07-07T18:20:04Z" },
  "data": {
    "count": 1,
    "page": 1,
    "totalPages": 1,
    "totalIncidents": 1,
    "incidents": [
      {
        "slug": "aws-increased-api-error-rates-n-virginia-2026-07-06",
        "title": "Increased API error rates (N. Virginia)",
        "status": "resolved",
        "severity": "minor",
        "startedAt": "2026-07-06T18:21:00Z",
        "updatedAt": "2026-07-06T20:04:00Z",
        "resolvedAt": "2026-07-06T20:04:00Z",
        "provider": { "slug": "aws", "name": "AWS" },
        "affectedServices": [{ "slug": "aws-ec2", "name": "EC2" }],
        "links": {
          "html": "/incidents/aws-increased-api-error-rates-n-virginia-2026-07-06",
          "api": "/api/v1/incidents/aws-increased-api-error-rates-n-virginia-2026-07-06",
          "alerts": "https://outagedeck.com/account?stack=aws&utm_source=api&utm_medium=response&utm_campaign=api_alerts&utm_content=incident"
        }
      }
    ]
  }
}

Machine-readable spec

This endpoint is described in the OpenAPI 3.1 document, ready for Postman, Insomnia, or code generation.

OpenAPI 3.1

https://outagedeck.com/api/v1/openapi