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

List services

ParameterInTypeDescription
providerquerystringFilter by provider slug. An unknown slug answers an empty result set.
statusqueryoperational | degraded | partial_outage | major_outage | maintenance | unknownFilter by the service's current status.
qquerystringCase-insensitive match against name and slug.
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/services?provider=github&status=operational&limit=10"

Response (truncated)

{
  "meta": { "version": "v1", "generatedAt": "2026-07-07T18:20:04Z" },
  "data": {
    "count": 1,
    "page": 1,
    "totalPages": 1,
    "totalServices": 1,
    "services": [
      {
        "slug": "github-actions",
        "name": "Actions",
        "category": "ci",
        "status": "operational",
        "provider": {
          "slug": "github",
          "name": "GitHub",
          "html": "/providers/github",
          "api": "/api/v1/providers/github"
        },
        "counts": { "incidents": 12, "activeIncidents": 0 },
        "links": {
          "html": "/services/github-actions",
          "api": "/api/v1/services/github-actions",
          "alerts": "https://outagedeck.com/account?stack=github&utm_source=api&utm_medium=response&utm_campaign=api_alerts&utm_content=service"
        }
      }
    ]
  }
}

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