{
  "type": "object",
  "required": [
    "need"
  ],
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "buy",
        "source",
        "quote",
        "verify",
        "lease",
        "license",
        "hire",
        "retrieve",
        "convert",
        "other"
      ],
      "description": "What you want done"
    },
    "need": {
      "type": "string",
      "maxLength": 2000,
      "description": "The requirement in your own words"
    },
    "specifications": {
      "type": "object",
      "properties": {
        "need_type": {
          "type": "string",
          "enum": [
            "ELECTRICITY_SUPPLY",
            "NATURAL_GAS_SUPPLY",
            "ONSITE_SOLAR",
            "BATTERY_STORAGE",
            "EV_CHARGING",
            "DEMAND_RESPONSE"
          ],
          "description": "What the site needs",
          "x-facet": "specification"
        },
        "utility_territory": {
          "type": "string",
          "maxLength": 120,
          "description": "Utility or market (for example a distribution utility or ISO zone) and state",
          "x-facet": "geography"
        },
        "annual_kwh": {
          "type": "number",
          "minimum": 0,
          "description": "Annual electricity use in kWh",
          "x-facet": "quantity"
        },
        "peak_demand_kw": {
          "type": "number",
          "minimum": 0,
          "description": "Peak demand in kW",
          "x-facet": "quantity"
        },
        "annual_therms": {
          "type": "number",
          "minimum": 0,
          "description": "Annual gas use in therms",
          "x-facet": "quantity"
        },
        "contract_term_months": {
          "type": "integer",
          "minimum": 1,
          "description": "Contract term in months",
          "x-facet": "timing"
        },
        "start_date": {
          "type": "string",
          "maxLength": 40,
          "description": "Date supply or service must start (YYYY-MM-DD)",
          "x-facet": "timing"
        },
        "chargers": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of charging ports",
          "x-facet": "quantity"
        }
      }
    },
    "quantity": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "number"
        },
        "unit": {
          "type": "string"
        },
        "per": {
          "type": "string"
        }
      }
    },
    "timing": {
      "type": "object",
      "properties": {
        "earliest": {
          "type": "string"
        },
        "latest": {
          "type": "string"
        },
        "recurrence": {
          "type": "string"
        },
        "text": {
          "type": "string"
        }
      }
    },
    "geography": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      }
    },
    "budget": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "number"
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217, default USD"
        },
        "per": {
          "type": "string",
          "description": "total, unit, month, year, load, ..."
        }
      }
    },
    "requested_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 30,
      "description": "Result fields you need"
    },
    "contact": {
      "type": "object",
      "description": "Optional; stored apart and deleted after 180 days",
      "properties": {
        "email": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "organization": {
          "type": "string"
        }
      }
    }
  }
}