{"openapi":"3.1.0","info":{"title":"Stormwatch free partner pilot","version":"1.0.0","description":"Approved server-to-server keys only. No subscriber data, bulk export or automatic signup. Initial30requests/minute and1000/day shared across a partner’s keys;90day key lifetime. Keep coverage, source dates and attribution visible."},"servers":[{"url":"https://mystormwatch.com"}],"paths":{"/api/v1/history":{"post":{"operationId":"propertyHistory","summary":"Available historical storm records at one point","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryQuery"}}}},"security":[{"PartnerKey":[]}],"responses":{"200":{"description":"Versioned weather envelope with attribution and limitations"},"400":{"description":"URL parameters are not accepted"},"404":{"description":"Unknown public town"},"401":{"description":"Missing, invalid, expired or revoked key"},"403":{"description":"Scope or browser-origin refusal"},"422":{"description":"Invalid bounded request"},"429":{"description":"Partner minute/day allowance reached"},"503":{"description":"Pilot disabled, capacity busy or weather unavailable"}}}},"/api/v1/map/layers":{"post":{"operationId":"mapLayer","summary":"A bounded historical hail, wind-warning or flood-warning map layer","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LayerQuery"}}}},"security":[{"PartnerKey":[]}],"responses":{"200":{"description":"Versioned weather envelope with attribution and limitations"},"400":{"description":"URL parameters are not accepted"},"404":{"description":"Unknown public town"},"401":{"description":"Missing, invalid, expired or revoked key"},"403":{"description":"Scope or browser-origin refusal"},"422":{"description":"Invalid bounded request"},"429":{"description":"Partner minute/day allowance reached"},"503":{"description":"Pilot disabled, capacity busy or weather unavailable"}}}},"/api/v1/map/region":{"post":{"operationId":"mapRegion","summary":"One historical hail, wind-warning, flood-warning or ground-report layer inside a box of up to 5 degrees","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegionQuery"}}}},"security":[{"PartnerKey":[]}],"responses":{"200":{"description":"Versioned weather envelope with attribution and limitations"},"400":{"description":"URL parameters are not accepted"},"404":{"description":"Unknown public town"},"401":{"description":"Missing, invalid, expired or revoked key"},"403":{"description":"Scope or browser-origin refusal"},"422":{"description":"Invalid bounded request"},"429":{"description":"Partner minute/day allowance reached"},"503":{"description":"Pilot disabled, capacity busy or weather unavailable"}}}},"/api/v1/map/storm-days":{"post":{"operationId":"mapStormDays","summary":"What fell inside a box of up to 5 degrees on up to 31 storm days; unknown when a source could not be read","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StormDaysQuery"}}}},"security":[{"PartnerKey":[]}],"responses":{"200":{"description":"Versioned weather envelope with attribution and limitations"},"400":{"description":"URL parameters are not accepted"},"404":{"description":"Unknown public town"},"401":{"description":"Missing, invalid, expired or revoked key"},"403":{"description":"Scope or browser-origin refusal"},"422":{"description":"Invalid bounded request"},"429":{"description":"Partner minute/day allowance reached"},"503":{"description":"Pilot disabled, capacity busy or weather unavailable"}}}},"/api/v1/weather/{state}/{town}":{"get":{"operationId":"townWeather","summary":"Existing source-backed weather media for a public Census town","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string","maxLength":32}},{"name":"town","in":"path","required":true,"schema":{"type":"string","maxLength":100}}],"security":[{"PartnerKey":[]}],"responses":{"200":{"description":"Versioned weather envelope with attribution and limitations"},"400":{"description":"URL parameters are not accepted"},"404":{"description":"Unknown public town"},"401":{"description":"Missing, invalid, expired or revoked key"},"403":{"description":"Scope or browser-origin refusal"},"422":{"description":"Invalid bounded request"},"429":{"description":"Partner minute/day allowance reached"},"503":{"description":"Pilot disabled, capacity busy or weather unavailable"}}}}},"components":{"securitySchemes":{"PartnerKey":{"type":"http","scheme":"bearer","description":"Keep on your backend. Never in URLs, browser bundles, mobile apps or iframe markup."}},"schemas":{"HistoryQuery":{"additionalProperties":false,"properties":{"lat":{"maximum":90,"minimum":-90,"title":"Lat","type":"number"},"lon":{"maximum":180,"minimum":-180,"title":"Lon","type":"number"},"hail_min":{"default":0.75,"maximum":8.5,"minimum":0.5,"title":"Hail Min","type":"number"},"wind_min":{"default":60,"maximum":200,"minimum":58,"title":"Wind Min","type":"integer"}},"required":["lat","lon"],"title":"HistoryQuery","type":"object"},"LayerQuery":{"additionalProperties":false,"properties":{"lat":{"maximum":90,"minimum":-90,"title":"Lat","type":"number"},"lon":{"maximum":180,"minimum":-180,"title":"Lon","type":"number"},"hail_min":{"default":0.75,"maximum":8.5,"minimum":0.5,"title":"Hail Min","type":"number"},"wind_min":{"default":60,"maximum":200,"minimum":58,"title":"Wind Min","type":"integer"},"day":{"format":"date","title":"Day","type":"string"},"kind":{"enum":["hail","wind","flood"],"title":"Kind","type":"string"}},"required":["lat","lon","day","kind"],"title":"LayerQuery","type":"object"},"RegionQuery":{"additionalProperties":false,"properties":{"south":{"maximum":90,"minimum":-90,"title":"South","type":"number"},"west":{"maximum":180,"minimum":-180,"title":"West","type":"number"},"north":{"maximum":90,"minimum":-90,"title":"North","type":"number"},"east":{"maximum":180,"minimum":-180,"title":"East","type":"number"},"hail_min":{"default":0.75,"maximum":8.5,"minimum":0.5,"title":"Hail Min","type":"number"},"wind_min":{"default":60,"maximum":200,"minimum":58,"title":"Wind Min","type":"integer"},"day":{"format":"date","title":"Day","type":"string"},"kind":{"enum":["hail","wind","flood","reports"],"title":"Kind","type":"string"}},"required":["south","west","north","east","day","kind"],"title":"RegionQuery","type":"object"},"StormDaysQuery":{"additionalProperties":false,"properties":{"south":{"maximum":90,"minimum":-90,"title":"South","type":"number"},"west":{"maximum":180,"minimum":-180,"title":"West","type":"number"},"north":{"maximum":90,"minimum":-90,"title":"North","type":"number"},"east":{"maximum":180,"minimum":-180,"title":"East","type":"number"},"hail_min":{"default":0.75,"maximum":8.5,"minimum":0.5,"title":"Hail Min","type":"number"},"wind_min":{"default":60,"maximum":200,"minimum":58,"title":"Wind Min","type":"integer"},"start":{"format":"date","title":"Start","type":"string"},"end":{"format":"date","title":"End","type":"string"}},"required":["south","west","north","east","start","end"],"title":"StormDaysQuery","type":"object"}}}}