{
 "openapi": "3.1.0",
 "info": {
  "title": "Burn Ban Today API",
  "version": "1.0.0",
  "description": "Read-only county burn ban status, refreshed hourly from official state sources and NWS fire-weather alerts. Static JSON files; no key. Please cite burnbantoday.com."
 },
 "servers": [
  {
   "url": "https://burnbantoday.com/api/v1"
  }
 ],
 "paths": {
  "/index.json": {
   "get": {
    "summary": "Covered states and ban counts",
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/{state}.json": {
   "get": {
    "summary": "Every county in a state",
    "parameters": [
     {
      "name": "state",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "example": "texas"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/{state}/{county}.json": {
   "get": {
    "summary": "One county: is there a burn ban today?",
    "parameters": [
     {
      "name": "state",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "example": "texas"
      }
     },
     {
      "name": "county",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "example": "bexar-county"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "burnBan (boolean), status (ban|partial|advisory|none), label, since, checked, source, fireWeather"
     }
    }
   }
  }
 }
}