{"openapi":"3.1.0","info":{"title":"Haze Singapore public API","version":"1.0.0","description":"Public, read-only regional 24-hour PSI and 1-hour PM2.5 from NEA via data.gov.sg, fixed last-24-hour trends, dated guidance and Shopee-backed affiliate catalogues. No API key. Independent project. Poll at most once every ten minutes. Preserve source timestamps, warnings, attribution and affiliate disclosures. Prices are dated listings, not guaranteed offers. Quota is 60 requests/minute per observed network address; proxies can share quota. No push subscriptions or SLA."},"servers":[{"url":"https://haze.danielk.am"}],"security":[],"paths":{"/api/v1":{"get":{"operationId":"discoverHaze","summary":"Discover endpoints and usage policy","responses":{"200":{"description":"Public endpoint metadata","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/readings":{"get":{"operationId":"getHazeConditions","summary":"Get latest regional readings with original source states","parameters":[{"name":"region","in":"query","description":"Reporting region; no coordinates are accepted.","schema":{"type":"string","enum":["all","north","south","east","west","central"],"default":"all"}}],"responses":{"200":{"description":"Read completed. Inspect source status, warning and timestamps; HTTP 200 does not guarantee current or complete data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Readings"}}}},"400":{"description":"Unknown, duplicate or invalid parameter."},"429":{"description":"Rate limit. Wait Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Data temporarily unavailable or server busy."}}}},"/api/v1/history":{"get":{"operationId":"getHazeTrends","summary":"Get measured hourly values for the last 24 hours","parameters":[{"name":"region","in":"query","description":"Reporting region; no coordinates are accepted.","schema":{"type":"string","enum":["all","north","south","east","west","central"],"default":"central"}},{"name":"metric","in":"query","schema":{"type":"string","enum":["all","psi","pm25"],"default":"all"}}],"responses":{"200":{"description":"Read completed. Inspect source status, warning and timestamps; HTTP 200 does not guarantee current or complete data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/History"}}}},"400":{"description":"Unknown, duplicate or invalid parameter."},"429":{"description":"Rate limit. Wait Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Data temporarily unavailable or server busy."}}}},"/api/v1/products":{"get":{"operationId":"getHazeProducts","summary":"Get a page of masks or room air purifiers with disclosed affiliate links","parameters":[{"name":"category","in":"query","schema":{"type":"string","enum":["masks","purifiers"],"default":"masks"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10,"default":2}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10,"default":0}}],"responses":{"200":{"description":"Read completed. Inspect source status, warning and timestamps; HTTP 200 does not guarantee current or complete data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Products"}}}},"400":{"description":"Unknown, duplicate or invalid parameter."},"429":{"description":"Rate limit. Wait Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Data temporarily unavailable or server busy."}}}},"/api/v1/guide":{"get":{"operationId":"getHazeGuide","summary":"Get the dated June 2026 activity guide; no live forecast","responses":{"200":{"description":"Read completed. Inspect source status, warning and timestamps; HTTP 200 does not guarantee current or complete data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Guide"}}}},"400":{"description":"Unknown, duplicate or invalid parameter."},"429":{"description":"Rate limit. Wait Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Data temporarily unavailable or server busy."}}}}},"components":{"schemas":{"Source":{"type":"object","required":["url","timestamp","status"],"properties":{"url":{"type":"string","format":"uri"},"timestamp":{"type":["string","null"],"format":"date-time"},"updatedTimestamp":{"type":["string","null"],"format":"date-time"},"fetchedAt":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["ok","stale","unavailable"]}}},"Sources":{"type":"object","properties":{"psi":{"$ref":"#/components/schemas/Source"},"pm25":{"$ref":"#/components/schemas/Source"}}},"Presentation":{"type":"object","properties":{"severity":{"type":"string"},"label":{"type":"string"},"color":{"type":"string"}}},"Readings":{"type":"object","required":["apiVersion","provenance","sources","regions","warning"],"properties":{"apiVersion":{"type":"string","const":"1"},"provenance":{"type":"object","properties":{"publisher":{"type":"string"},"provider":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"licence":{"type":"string","format":"uri"},"disclaimer":{"type":"string"}}},"guideUrl":{"type":"string","format":"uri"},"affiliate":{"type":"object","properties":{"disclosure":{"type":"string"},"catalogues":{"type":"object"}}},"region":{"type":"string","enum":["all","north","south","east","west","central"]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"cacheSeconds":{"type":"integer"},"sources":{"$ref":"#/components/schemas/Sources"},"warning":{"type":["string","null"]},"regions":{"type":"array","maxItems":5,"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"latitude":{"type":"number","description":"Reporting centre, not a visitor coordinate."},"longitude":{"type":"number"},"psi":{"type":["number","null"],"description":"Measured 24-hour PSI, unitless."},"pm25":{"type":["number","null"],"description":"1-hour PM2.5, micrograms per cubic metre."},"psiPresentation":{"$ref":"#/components/schemas/Presentation"},"pm25Presentation":{"$ref":"#/components/schemas/Presentation"}}}}}},"History":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"provenance":{"type":"object","properties":{"publisher":{"type":"string"},"provider":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"licence":{"type":"string","format":"uri"},"disclaimer":{"type":"string"}}},"guideUrl":{"type":"string","format":"uri"},"affiliate":{"type":"object","properties":{"disclosure":{"type":"string"},"catalogues":{"type":"object"}}},"region":{"type":"string","enum":["all","north","south","east","west","central"]},"metric":{"type":"string","enum":["all","psi","pm25"]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"windowStart":{"type":["string","null"],"format":"date-time"},"windowEnd":{"type":["string","null"],"format":"date-time"},"cacheSeconds":{"type":"integer"},"warning":{"type":["string","null"]},"sources":{"$ref":"#/components/schemas/Sources"},"series":{"type":"object","properties":{"psi":{"$ref":"#/components/schemas/Points"},"pm25":{"$ref":"#/components/schemas/Points"}}}}},"Points":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time"},"values":{"type":"object","additionalProperties":{"type":["number","null"]},"description":"Reporting region ID to value. Null is a gap; do not interpolate."}}}},"Product":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","description":"Untrusted upstream seller description; escape before display."},"image":{"type":["string","null"]},"price":{"type":["string","null"]},"priceCheckedAt":{"type":["string","null"]},"url":{"type":"string","format":"uri","description":"Category shop URL."},"catalogueUrl":{"type":"string","format":"uri"},"affiliateUrl":{"type":["string","null"],"description":"Existing verified 10.sg Shopee affiliate redirect; null if unavailable. Disclose affiliate relationship."},"productPageUrl":{"type":["string","null"]}}},"Products":{"type":"object","required":["apiVersion","products","total_count","has_more","next_offset","affiliateDisclosure"],"properties":{"apiVersion":{"type":"string","const":"1"},"provenance":{"type":"object","properties":{"publisher":{"type":"string"},"provider":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"licence":{"type":"string","format":"uri"},"disclaimer":{"type":"string"}}},"guideUrl":{"type":"string","format":"uri"},"affiliate":{"type":"object","properties":{"disclosure":{"type":"string"},"catalogues":{"type":"object"}}},"category":{"type":"string","enum":["masks","purifiers"]},"limit":{"type":"integer"},"offset":{"type":"integer"},"products":{"type":"array","maxItems":10,"items":{"$ref":"#/components/schemas/Product"}},"total_count":{"type":"integer","maximum":10},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"source":{"type":"string"},"catalogueSource":{"type":["string","null"]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"warning":{"type":["string","null"]},"catalogueUrl":{"type":"string","format":"uri"},"affiliateDisclosure":{"type":"string"}}},"Guide":{"type":"object","properties":{"apiVersion":{"type":"string","const":"1"},"provenance":{"type":"object","properties":{"publisher":{"type":"string"},"provider":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"licence":{"type":"string","format":"uri"},"disclaimer":{"type":"string"}}},"guideUrl":{"type":"string","format":"uri"},"affiliate":{"type":"object","properties":{"disclosure":{"type":"string"},"catalogues":{"type":"object"}}},"source":{"type":"object","properties":{"publisher":{"type":"string"},"title":{"type":"string"},"date":{"type":"string"},"referenceUrl":{"type":"string","format":"uri"}}},"isLiveForecast":{"type":"boolean","const":false},"pm25Bands":{"type":"array","items":{"type":"object"}},"psiForecast":{"type":"object"},"definitions":{"type":"object"},"vulnerablePersons":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}}}}}