{"components":{"schemas":{"ActiveIncident":{"properties":{"link":{"type":["string","null"]},"posted_at":{"type":["string","null"]},"service":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"}},"type":"object"},"AllPlatforms":{"properties":{"platforms":{"items":{"$ref":"#/components/schemas/PlatformStatus"},"type":"array"},"platforms_with_issues":{"items":{"type":"string"},"type":"array"},"summary":{"type":"string"}},"type":"object"},"Error":{"properties":{"error":{"type":"string"},"message":{"type":"string"},"settings_url":{"type":"string"},"upgrade_url":{"type":"string"}},"type":"object"},"Incident":{"properties":{"first_detected_at":{"format":"date-time","type":"string"},"id":{"type":"string"},"last_update_at":{"format":"date-time","type":["string","null"]},"link":{"type":["string","null"]},"name":{"type":"string"},"platform":{"type":"string"},"resolved":{"type":["boolean","null"]},"resolved_at":{"format":"date-time","type":["string","null"]},"service":{"type":"string"},"title":{"type":"string"}},"type":"object"},"IncidentList":{"properties":{"days":{"type":"integer"},"incidents":{"items":{"$ref":"#/components/schemas/Incident"},"type":"array"},"platform":{"type":["string","null"]},"summary":{"type":"string"}},"type":"object"},"PlatformStatus":{"properties":{"active_incidents":{"items":{"$ref":"#/components/schemas/ActiveIncident"},"type":"array"},"adstatus_url":{"type":"string"},"checked_at":{"type":["string","null"]},"covers":{"type":"string"},"data_age_seconds":{"type":["integer","null"]},"name":{"type":"string"},"official_status_url":{"type":"string"},"platform":{"type":"string"},"recorded_last_24h":{"items":{"$ref":"#/components/schemas/Incident"},"type":["array","null"]},"stale":{"type":"boolean"},"state":{"enum":["operational","issue","unknown"],"type":"string"},"summary":{"type":"string"},"unreadable_services":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"securitySchemes":{"apiKey":{"description":"Your AdStatus API key (starts with ads_), from Settings on adstatus.app.","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"support@adstatus.app","name":"AdStatus","url":"https://adstatus.app"},"description":"Live status and recent incidents for Meta Ads (Facebook, Instagram), Google Ads, Microsoft Advertising, Pinterest Ads, Amazon Ads, Shopify, ChatGPT and Claude, read from each provider's official status page. Read-only. Included with an AdStatus subscription: authenticate with your API key from AdStatus Settings. Every response includes a plain-language `summary`.","title":"AdStatus","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/incidents":{"get":{"description":"Incidents AdStatus recorded from official status pages, newest first, up to 25. resolved is true only when a resolution was recorded, otherwise null.","operationId":"getRecentIncidents","parameters":[{"description":"Omit for all platforms.","in":"query","name":"platform","required":false,"schema":{"enum":["meta","google","microsoft","pinterest","amazon","shopify","openai","claude"],"type":"string"}},{"in":"query","name":"days","required":false,"schema":{"default":7,"maximum":90,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentList"}}},"description":"Incident list."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid platform or days."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key."},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The account has no active AdStatus subscription."}},"summary":"Incidents recorded over the past days"}},"/api/v1/status":{"get":{"description":"Current state of all eight platforms in one call.","operationId":"checkAllPlatforms","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllPlatforms"}}},"description":"All platforms."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key."},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The account has no active AdStatus subscription."}},"summary":"Status of every monitored platform"}},"/api/v1/status/{platform}":{"get":{"description":"Current state of one platform from its official status page (refreshed at most every 60 seconds), active incidents, and incidents recorded in the last 24 hours. state is operational, issue, or unknown when the status page could not be read.","operationId":"checkPlatformStatus","parameters":[{"description":"meta = Facebook/Instagram/Meta Ads, google = Google Ads, microsoft = Microsoft Advertising/Bing Ads, pinterest, amazon = Amazon Ads, shopify, openai = ChatGPT, claude = Claude/Anthropic. Common names like \"facebook\" or \"bing\" also work.","in":"path","name":"platform","required":true,"schema":{"enum":["meta","google","microsoft","pinterest","amazon","shopify","openai","claude"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformStatus"}}},"description":"Platform status."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid platform or days."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key."},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The account has no active AdStatus subscription."}},"summary":"Is this platform down right now?"}}},"security":[{"apiKey":[]}],"servers":[{"url":"https://adstatus.app"}]}