Skip to content

Developers

Public JSON APIs for provider status and incident history

The public API is versioned under `/api/v1` and returns normalized JSON from the same repository layer that powers the public pages.

Endpoints

Current API surface

These endpoints are public today. They also create a natural upgrade path toward metered premium access later.

GET/api/v1/statusPublic

Summary endpoint with provider counts, recent incidents, and current provider snapshots.

GET/api/v1/providersPublic

List providers with optional query-string filters like `q`, `status`, and `sort`.

GET/api/v1/providers/[providerSlug]Public

Detailed provider payload with current status, services, active incidents, and recent history.

GET/api/v1/incidentsPublic

Incident archive endpoint with optional `provider`, `active`, and `limit` query filters.

GET/api/v1/incidents/[incidentSlug]Public

Detailed incident payload including timeline updates and affected services.

GET/api/v1/services/[serviceSlug]Upsell-ready

Service-level status payload for integrations that care about a specific provider dependency.

GET/api/v1/badges/[providerSlug]Public

Embeddable SVG status badge for READMEs, wikis, and dashboards. Safe to hotlink and never rate limited.

GET/api/v1/openapiPublic

Machine-readable OpenAPI 3.1 document describing every public endpoint, parameter, and response shape.

GET/feeds/incidents.xmlPublic

RSS 2.0 feed of recent incidents across all providers. Per-provider feeds live at /feeds/providers/[providerSlug].

Example request

curl https://outagedeck.com/api/v1/providers?q=github

On the roadmap

  • Webhook delivery for incident state changes
  • Historical exports for reporting and BI pipelines
  • Team-level alert routing and saved watchlists
  • Usage analytics for keyed API plans