{"openapi":"3.1.0","info":{"title":"Jefferson County Sheriff's Office Public API","version":"1.0.0","description":"Public, read-only data published by the Jefferson County Sheriff's Office (Colorado). No API key. Responses are JSON with open CORS. Errors on this surface are RFC 9457 `application/problem+json`. This is public information for planning and awareness, not an emergency service: call 911 for emergencies and (303) 980-7300 for non-emergencies.","contact":{"name":"Public Affairs, Jefferson County Sheriff's Office","email":"publicaffairs@jeffco.us","url":"https://www.jeffcosheriffco.gov/developers"},"license":{"name":"Public information; free to use with attribution","url":"https://www.jeffcosheriffco.gov/developers#terms"}},"servers":[{"url":"https://www.jeffcosheriffco.gov","description":"Production"}],"externalDocs":{"url":"https://www.jeffcosheriffco.gov/developers","description":"Developer resources"},"tags":[{"name":"fire-restrictions","description":"Fire restriction stage and National Weather Service Red Flag Warning status for unincorporated Jefferson County, Colorado."}],"paths":{"/api/fire-restrictions/status":{"get":{"operationId":"getFireRestrictionStatus","summary":"Current fire restriction and Red Flag Warning status for unincorporated Jefferson County, Colorado","description":"Machine-readable fire-restriction and Red Flag Warning status. Combines the live National Weather Service fire-weather feed with the Sheriff's published declaration.\n\n**Source of truth:** Red Flag Warning / Fire Weather Watch = National Weather Service; Stage 2 fire ban = Sheriff's declaration; Stage 1 during a Red Flag Warning = automatic per JCSO policy.\n\n**Freshness:** CDN-cached for 60 s (`s-maxage=60, stale-while-revalidate=300`) and purged when the Sheriff publishes a new declaration. Read `asOf` and re-fetch rather than storing the answer.\n\n**Limits:** no key; open CORS (`Access-Control-Allow-Origin: *`); edge rate limit of 60 requests per minute per IP, plus a 300-per-minute function backstop. Exceeding either returns 429 with `Retry-After`.\n\n**Tri-state fields:** `redFlagWarning.active`, `upcoming` and `fireWeatherWatch` are `true`, `false` or `null`; null means the NWS feed was unavailable (`resolved: false`) and must not be read as \"no warning\".\n\nPublic information for planning and awareness — never for emergencies (call 911).","tags":["fire-restrictions"],"responses":{"200":{"description":"Current status. Always 200 when the function runs: a CMS or NWS outage degrades fields to null rather than failing.","headers":{"Cache-Control":{"description":"Browser directive; the CDN window is carried separately.","schema":{"type":"string","examples":["public, max-age=0, must-revalidate"]}},"Link":{"description":"RFC 8288 links to this description (`service-desc`) and the API catalog (`api-catalog`).","schema":{"type":"string","examples":["</openapi.json>; rel=\"service-desc\", </.well-known/api-catalog>; rel=\"api-catalog\""]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FireRestrictionStatus"}}}},"405":{"description":"Method other than GET, HEAD or OPTIONS.","headers":{"Allow":{"description":"Methods this resource supports.","schema":{"type":"string","const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limited. Function-level limits return the JSON body below; edge (WAF) limits return a platform body. Wait `Retry-After` seconds.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"string","examples":["30"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimited"}}}}}}}},"components":{"schemas":{"FireRestrictionStatus":{"type":"object","description":"Combined fire-restriction and Red Flag Warning status for unincorporated Jefferson County, Colorado. Source-of-truth split: Red Flag Warning / Fire Weather Watch = National Weather Service (live); Stage 2 fire ban = Sheriff's declaration; Stage 1 during a Red Flag Warning = automatic per JCSO policy.","required":["official","authority","jurisdiction","asOf","url","restriction","redFlagWarning","updated"],"properties":{"official":{"type":"boolean","const":true,"description":"Always true: this is the Sheriff's Office's own published status."},"authority":{"type":"string","description":"Publishing authority.","examples":["Jefferson County Sheriff's Office"]},"jurisdiction":{"type":"string","description":"Area the status applies to. Municipalities (Lakewood, Arvada, Golden, Wheat Ridge, Westminster, Edgewater) set their own rules.","examples":["Unincorporated Jefferson County, Colorado"]},"asOf":{"type":"string","description":"Mountain-Time calendar date the response was generated, as a long English date (e.g. \"June 24, 2026\"). Not ISO 8601. Quote it with any answer and re-fetch rather than caching beyond the 60 s CDN window.","examples":["June 24, 2026"]},"url":{"type":"string","format":"uri","description":"Human-readable page with the same status, current rules and FAQs.","examples":["https://www.jeffcosheriffco.gov/safety/wildland-fire/fire-restrictions"]},"restriction":{"$ref":"#/components/schemas/Restriction"},"redFlagWarning":{"$ref":"#/components/schemas/RedFlagWarning"},"updated":{"type":["string","null"],"description":"ISO 8601 timestamp of the most recent underlying change: the NWS alert `sent` time when one covers the county, else the start date of the Sheriff's order, else null when nothing is in effect."}}},"Restriction":{"type":"object","description":"Effective fire-restriction stage, combining the Sheriff's declaration with the automatic-Stage-1 rule.","required":["stage","label","stage1FromRedFlag","source"],"properties":{"stage":{"type":"string","enum":["none","active","stage1","stage2"],"description":"`none` = no restrictions; `stage1` = Stage 1 fire restrictions; `stage2` = Stage 2 fire ban (outranks Stage 1); `active` = a Sheriff's fire notification is in effect that does not name a stage — treat as restrictions in effect and read `label`."},"label":{"type":"string","description":"Human-readable status for the stage, suitable to quote verbatim.","examples":["No fire restrictions in effect","Fire restrictions in effect","Stage 1 fire restrictions in effect","Stage 2 fire ban in effect"]},"stage1FromRedFlag":{"type":"boolean","description":"True when Stage 1 is in effect solely because of an active NWS Red Flag Warning (no Sheriff declaration); it ends with the warning."},"source":{"type":["string","null"],"enum":["Jefferson County Sheriff's order","Automatic during NWS Red Flag Warning",null],"description":"What put the stage in effect: a Sheriff's order, the automatic Red Flag rule, or null when `stage` is `none`."}}},"RedFlagWarning":{"type":"object","description":"Live National Weather Service fire-weather status for the county. The three boolean fields are tri-state: `true` / `false` when the NWS feed resolved, `null` when it did not. `active` = in effect right now; `upcoming` = issued but does not begin until a future time.","required":["active","upcoming","fireWeatherWatch","headline","onset","ends","source","resolved"],"properties":{"active":{"type":["boolean","null"],"description":"A Red Flag Warning is in effect RIGHT NOW (onset has passed and it has not ended); null when the live NWS fetch is unavailable — do NOT read as \"no warning\"."},"upcoming":{"type":["boolean","null"],"description":"A Red Flag Warning has been issued for the area but does not take effect until a future time; null when the live NWS fetch is unavailable — do NOT read as \"no warning\"."},"fireWeatherWatch":{"type":["boolean","null"],"description":"A Fire Weather Watch (upcoming risk) is in effect; null when the live NWS fetch is unavailable — do NOT read as \"no warning\"."},"headline":{"type":["string","null"],"description":"NWS headline, e.g. \"Red Flag Warning issued June 23 at 4:10PM MDT by NWS Denver CO\". Null when no alert covers the county or the feed is unavailable."},"onset":{"type":["string","null"],"description":"ISO 8601 onset — when the warning takes effect (NWS `onset`). Null when NWS omits it or no alert is selected."},"ends":{"type":["string","null"],"description":"ISO 8601 end (NWS `ends`, else `expires`) of the selected warning. Null when no alert is selected."},"source":{"type":"string","const":"National Weather Service","description":"Issuing authority for the Red Flag fields."},"resolved":{"type":"boolean","description":"True when the live NWS fetch (or last-known-good copy) resolved. False = degraded/unknown — callers must NOT assert \"no Red Flag Warning\" in that case; link to https://www.weather.gov/bou/ instead."}}},"Problem":{"type":"object","description":"RFC 9457 problem details (`application/problem+json`).","required":["type","title","status","detail","code","hint"],"properties":{"type":{"type":"string","const":"about:blank"},"title":{"type":"string","description":"Short human title, e.g. \"Method Not Allowed\"."},"status":{"type":"integer","description":"HTTP status code, repeated in the body."},"detail":{"type":"string","description":"Human explanation specific to this occurrence."},"code":{"type":"string","description":"Stable machine-readable code.","examples":["not_found","method_not_allowed"]},"hint":{"type":"string","description":"What the caller should do next."},"instance":{"type":"string","description":"Request path this problem relates to (never the query string)."}}},"RateLimited":{"type":"object","description":"Body of a function-level 429 (per-IP sliding window). Edge (WAF) 429s carry a platform body instead; honour `Retry-After` either way.","required":["error"],"properties":{"error":{"type":"string","examples":["Too many requests. Please slow down."]}}}}}}