is-it-down

Is anything I depend on broken right now? Checks every supported provider in parallel and returns a one-sentence summary plus per-service detail. Use this first: it answers the whole question in one call. Optionally narrow with ?services=github,npm. A provider whose status page cannot be read is reported as "unknown", never as healthy.

{
  "type": "object",
  "properties": {
    "services": {
      "type": "string",
      "x-in": "query",
      "description": "Optional comma-separated slugs to narrow the check, e.g. \"github,npm,cloudflare\". Omit to check all."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "down": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Slugs with a major or critical incident open."
    },
    "checked": {
      "type": "integer",
      "description": "How many services were checked."
    },
    "summary": {
      "type": "string",
      "description": "One sentence answering \"is anything broken right now\", safe to show verbatim."
    },
    "unknown": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Slugs whose status page could not be read."
    },
    "degraded": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Slugs with a minor incident open."
    },
    "services": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "service",
          "name",
          "state",
          "meaning",
          "reachable"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Human name of the provider."
          },
          "state": {
            "enum": [
              "operational",
              "degraded",
              "down",
              "unknown"
            ],
            "type": "string",
            "description": "Normalised state. \"unknown\" means the status page could not be read, NOT that the service is down."
          },
          "cached": {
            "type": "boolean",
            "description": "Whether this answer came from the 45 second cache rather than a fresh fetch."
          },
          "healthy": {
            "type": "boolean",
            "nullable": true,
            "description": "True when operational, false when degraded or down, null when unknown."
          },
          "meaning": {
            "type": "string",
            "description": "Plain-language reading of the state, safe to show a user verbatim."
          },
          "service": {
            "type": "string",
            "description": "The slug that was checked."
          },
          "indicator": {
            "type": "string",
            "nullable": true,
            "description": "Raw statuspage.io indicator: none, minor, major or critical."
          },
          "reachable": {
            "type": "boolean",
            "description": "Whether the status page itself answered."
          },
          "updated_at": {
            "type": "string",
            "nullable": true,
            "description": "When the provider last updated the page (ISO 8601)."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "The provider's own one-line summary, when it publishes one."
          },
          "status_page": {
            "type": "string",
            "description": "URL a human can open to read the full incident history."
          }
        }
      },
      "description": "Full per-service detail."
    },
    "all_operational": {
      "type": "boolean",
      "description": "True only when every checked service reports no known problems AND every status page was reachable."
    }
  },
  "required": [
    "checked",
    "all_operational",
    "summary",
    "services"
  ]
}

Current incident state for one named service. Returns the normalised state (operational, degraded, down, unknown), the provider's own description, and a link to the full status page. Use when you already know which provider you care about.

{
  "type": "object",
  "properties": {
    "service": {
      "enum": [
        "github",
        "npm",
        "cloudflare",
        "anthropic",
        "openai",
        "vercel",
        "netlify",
        "render",
        "supabase",
        "mongodb",
        "digitalocean",
        "docker",
        "circleci",
        "sentry",
        "datadog",
        "twilio",
        "atlassian",
        "bitbucket",
        "discord",
        "hashicorp"
      ],
      "type": "string",
      "x-in": "query",
      "description": "Slug of the service to check. One of: github, npm, cloudflare, anthropic, openai, vercel, netlify, render, supabase, mongodb, digitalocean, docker, circleci, sentry, datadog, twilio, atlassian, bitbucket, discord, hashicorp."
    }
  },
  "required": [
    "service"
  ]
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human name of the provider."
    },
    "state": {
      "enum": [
        "operational",
        "degraded",
        "down",
        "unknown"
      ],
      "type": "string",
      "description": "Normalised state. \"unknown\" means the status page could not be read, NOT that the service is down."
    },
    "cached": {
      "type": "boolean",
      "description": "Whether this answer came from the 45 second cache rather than a fresh fetch."
    },
    "healthy": {
      "type": "boolean",
      "nullable": true,
      "description": "True when operational, false when degraded or down, null when unknown."
    },
    "meaning": {
      "type": "string",
      "description": "Plain-language reading of the state, safe to show a user verbatim."
    },
    "service": {
      "type": "string",
      "description": "The slug that was checked."
    },
    "indicator": {
      "type": "string",
      "nullable": true,
      "description": "Raw statuspage.io indicator: none, minor, major or critical."
    },
    "reachable": {
      "type": "boolean",
      "description": "Whether the status page itself answered."
    },
    "updated_at": {
      "type": "string",
      "nullable": true,
      "description": "When the provider last updated the page (ISO 8601)."
    },
    "description": {
      "type": "string",
      "nullable": true,
      "description": "The provider's own one-line summary, when it publishes one."
    },
    "status_page": {
      "type": "string",
      "description": "URL a human can open to read the full incident history."
    }
  },
  "required": [
    "service",
    "name",
    "state",
    "meaning",
    "reachable"
  ]
}

Which services can be checked. Lists every supported slug with its human name and status page URL. The list is fixed; arbitrary URLs are not accepted.

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "services": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "service": {
            "type": "string",
            "description": "Slug to pass as ?service="
          },
          "status_page": {
            "type": "string"
          }
        }
      }
    }
  }
}