{
  "openapi": "3.1.0",
  "info": {
    "title": "WateringDay API",
    "version": "1.0.0",
    "description": "Lawn watering days for one address at a time. Free for answering individual questions with a link to wateringday.app; bulk copying is not permitted. Rate limited."
  },
  "servers": [
    {
      "url": "https://wateringday.app"
    }
  ],
  "paths": {
    "/api/v1/day": {
      "get": {
        "operationId": "getWateringDay",
        "summary": "Watering days, hours and next dates for one address",
        "parameters": [
          {
            "name": "utility",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "austin",
                "san-antonio",
                "las-vegas",
                "dallas",
                "fort-worth",
                "los-angeles",
                "orlando",
                "tampa",
                "hillsborough-county"
              ]
            }
          },
          {
            "name": "house",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "House number (only the last digit is used)."
          },
          {
            "name": "group",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "A",
                "B",
                "C",
                "D",
                "E",
                "F"
              ]
            },
            "description": "Las Vegas watering group."
          },
          {
            "name": "schedule",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Property/watering type id from /data/utilities.json; default if omitted."
          },
          {
            "name": "date",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Local date to evaluate; today if omitted."
          }
        ],
        "responses": {
          "200": {
            "description": "Watering days"
          },
          "400": {
            "description": "Missing or unknown input"
          }
        }
      }
    }
  }
}