{"components":{"securitySchemes":{"license":{"scheme":"bearer","type":"http"}}},"info":{"description":"Cached regional service availability signals and observation history. Licenses sold and managed by Evelode.com.","title":"UptimeScout API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v1/history":{"get":{"description":"Read observed status history. Missing intervals are unknown, never measured uptime.","operationId":"history","parameters":[{"in":"query","name":"service","required":true,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}},"/v1/incidents":{"get":{"description":"List services with fresh elevated disruption signals; not confirmed provider incidents.","operationId":"incidents","parameters":[{"in":"query","name":"service","required":false,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}},"/v1/services":{"get":{"description":"Search the service catalog and get cached availability observations.","operationId":"services","parameters":[{"in":"query","name":"service","required":false,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}},"/v1/stats":{"get":{"description":"Calculate observed sample ratios, not measured uptime.","operationId":"stats","parameters":[{"in":"query","name":"service","required":true,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}},"/v1/status":{"get":{"description":"Get a service status with observation time and explicit freshness.","operationId":"status","parameters":[{"in":"query","name":"service","required":true,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}},"/v1/statuses":{"get":{"description":"Get a batch of cached service statuses.","operationId":"statuses","parameters":[{"in":"query","name":"service","required":false,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}},"/v1/summary":{"get":{"description":"Summarize reported availability across the catalog or selected services.","operationId":"summary","parameters":[{"in":"query","name":"service","required":false,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"services","required":false,"schema":{"description":"Comma-separated service IDs (maximum 100)","type":"string"}},{"in":"query","name":"region","required":false,"schema":{"pattern":"^[A-Za-z]{2}$","type":"string"}},{"in":"query","name":"q","required":false,"schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":1,"type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"hours","required":false,"schema":{"maximum":2160,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Cached observations"},"400":{"description":"Invalid parameters"},"401":{"description":"License required"},"403":{"description":"Invalid license"},"429":{"description":"Quota or rate limit"},"503":{"description":"Service unavailable"}},"security":[{"license":[]}]}}},"servers":[{"url":"https://api.uptimescout.com"}]}
