Generation Mix

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/carbon-intensity/main/json-schema/generation-mix.json",
  "title": "Generation Mix",
  "description": "Electricity generation mix data showing percentage contribution of each fuel type for a 30-minute period",
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "format": "date-time",
      "description": "Start of the half-hour period in ISO 8601 format",
      "example": "2018-01-20T12:00Z"
    },
    "to": {
      "type": "string",
      "format": "date-time",
      "description": "End of the half-hour period in ISO 8601 format",
      "example": "2018-01-20T12:30Z"
    },
    "generationmix": {
      "type": "array",
      "description": "List of fuel types and their percentage contributions to electricity generation",
      "items": {
        "type": "object",
        "properties": {
          "fuel": {
            "type": "string",
            "description": "Fuel type identifier",
            "enum": ["biomass", "coal", "imports", "gas", "nuclear", "other", "hydro", "solar", "wind"],
            "example": "gas"
          },
          "perc": {
            "type": "number",
            "format": "float",
            "description": "Percentage of total generation from this fuel type",
            "minimum": 0,
            "maximum": 100,
            "example": 43.6
          }
        },
        "required": ["fuel", "perc"]
      }
    }
  },
  "required": ["from", "to", "generationmix"]
}