{"openapi":"3.1.0","info":{"title":"outages.live API","version":"1.0.0","description":"A free live outage feed for your agents: the official status pages of 260 cloud, AI, and developer providers, read every few minutes and merged into one live feed."},"servers":[{"url":"https://outages.live"}],"paths":{"/api/v1/providers":{"get":{"summary":"List every provider with its current status","responses":{"200":{"description":"Providers","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":["string","null"]},"providers":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}}}}}}}}},"/api/v1/providers/{id}":{"get":{"summary":"Get one provider, its active incidents, 90 days of history, and reviewed user reports of the last 24 hours","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Provider id or name, for example github"}],"responses":{"200":{"description":"Provider detail","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No tracked provider has this id"}}}},"/api/v1/outages":{"get":{"summary":"List active incidents","parameters":[{"name":"state","in":"query","schema":{"type":"string","enum":["active","recent"]}},{"name":"providers","in":"query","schema":{"type":"string"},"description":"Comma-separated provider ids"},{"name":"kind","in":"query","schema":{"type":"string","enum":["all"]},"description":"all adds maintenance"}],"responses":{"200":{"description":"Incidents","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":["string","null"]},"outages":{"type":"array","items":{"$ref":"#/components/schemas/Outage"}}}}}}}}}},"/api/v1/outages/{id}":{"get":{"summary":"Get one incident with every update","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Incident id"}],"responses":{"200":{"description":"Incident","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Outage"}}}},"404":{"description":"No outage has this id"}}}},"/api/v1/feedback":{"post":{"summary":"Send feedback: a provider to add, data that looks wrong, or an idea","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind","message"],"properties":{"kind":{"type":"string","enum":["missing_provider","wrong_data","idea","other"]},"message":{"type":"string","maxLength":2000},"provider":{"type":"string","description":"Optional provider the feedback is about, tracked or not"}}}}}},"responses":{"201":{"description":"Feedback received","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}}}}}},"400":{"description":"The message is missing or too long"},"429":{"description":"Too much feedback from this visitor or from everyone today"}}}},"/ask":{"get":{"summary":"Ask a natural-language question about provider status (NLWeb)","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Answer with cited pages","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Health":{"type":"string","enum":["operational","maintenance","degraded","partial_outage","major_outage","unknown"]},"Outage":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"provider":{"type":"string"},"kind":{"type":"string","enum":["incident","maintenance"]},"title":{"type":"string"},"active":{"type":"boolean"},"state":{"type":"string"},"impact":{"$ref":"#/components/schemas/Health"},"worstImpact":{"$ref":"#/components/schemas/Health"},"components":{"type":"array","items":{"type":"string"}},"summary":{"type":["string","null"]},"latestUpdate":{"type":["string","null"]},"startedAt":{"type":"string","format":"date-time"},"resolvedAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"officialUrl":{"type":"string","format":"uri"},"carrierRoute":{"type":"boolean","description":"The incident concerns one carrier's network in one country, at a messaging provider."}}},"Provider":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"status":{"$ref":"#/components/schemas/Health"},"summary":{"type":["string","null"]},"checkedAt":{"type":["string","null"],"format":"date-time"},"stale":{"type":"boolean"},"url":{"type":"string","format":"uri"},"statusPageUrl":{"type":"string","format":"uri"}}}}}}