Average Electric Bill

{
  "type": "object",
  "required": [
    "state",
    "home_size_sqft",
    "household_size",
    "kwh"
  ],
  "properties": {
    "kwh": {
      "type": "number",
      "description": "kWh used on this bill (one month)."
    },
    "month": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Month the bill covers (1-12). Optional but recommended: use varies a lot by season."
    },
    "state": {
      "type": "string",
      "description": "U.S. state or D.C.: two-letter code (TX) or name (Texas)."
    },
    "utility": {
      "type": "string",
      "description": "Electric utility or retail provider name. Optional; compares the rate with that utility's average."
    },
    "amount_due": {
      "type": "number",
      "description": "Total amount on the bill in USD. Optional; enables the rate comparison."
    },
    "home_size_sqft": {
      "type": "number",
      "description": "Home size in square feet, e.g. 1800."
    },
    "household_size": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Number of people living in the home."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Utility name or initials."
    },
    "state": {
      "type": "string",
      "description": "Optional: limit to one state (code or name)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter code, state name, or 'US'. Omit for every state."
    }
  },
  "additionalProperties": false
}