{
  "schema_version": "1.0",
  "generated_at": "2026-08-04T18:53:47.813764Z",
  "country_code": "BG",
  "country": "Bulgaria",
  "reference_system": {
    "installedKwp": 10,
    "orientation": "S",
    "tiltDeg": 35,
    "systemLossPct": 14
  },
  "city_count": 5,
  "summary": {
    "tomorrow_average_kwh": 52.36,
    "tomorrow_min_kwh": 46.7,
    "tomorrow_max_kwh": 54.1,
    "typical_annual_average_kwh": 13333.728,
    "typical_annual_min_kwh": 13053.95,
    "typical_annual_max_kwh": 13685.37
  },
  "cities": [
    {
      "city_id": "plovdiv",
      "city": "Plovdiv",
      "latitude": 42.1354,
      "longitude": 24.7453,
      "forecast": {
        "cityId": "plovdiv",
        "name": "Plovdiv",
        "lat": 42.1354,
        "lon": 24.7453,
        "timezone": "Europe/Sofia",
        "featured": true,
        "targetDate": "2026-08-05",
        "expectedKwh": 46.7,
        "lowKwh": 36.2,
        "highKwh": 55.2,
        "bestWindowStart": "2026-08-05T13:00:00+03:00",
        "bestWindowEnd": "2026-08-05T17:00:00+03:00",
        "confidence": "medium",
        "fetchedAt": "2026-08-04T18:53:39.460684Z",
        "freshness": "fresh",
        "stale": false
      },
      "typical_annual_kwh": 13685.37,
      "typical_monthly": [
        {
          "month": 1,
          "averageDailyKwh": 23.25,
          "monthlyKwh": 720.88,
          "variabilityKwh": 191.18
        },
        {
          "month": 2,
          "averageDailyKwh": 30.31,
          "monthlyKwh": 848.62,
          "variabilityKwh": 161.71
        },
        {
          "month": 3,
          "averageDailyKwh": 36.87,
          "monthlyKwh": 1143,
          "variabilityKwh": 126.52
        },
        {
          "month": 4,
          "averageDailyKwh": 42.66,
          "monthlyKwh": 1279.88,
          "variabilityKwh": 135.72
        },
        {
          "month": 5,
          "averageDailyKwh": 43.52,
          "monthlyKwh": 1349,
          "variabilityKwh": 130.4
        },
        {
          "month": 6,
          "averageDailyKwh": 45.85,
          "monthlyKwh": 1375.58,
          "variabilityKwh": 94.37
        },
        {
          "month": 7,
          "averageDailyKwh": 49.47,
          "monthlyKwh": 1533.53,
          "variabilityKwh": 98.2
        },
        {
          "month": 8,
          "averageDailyKwh": 49.55,
          "monthlyKwh": 1535.9,
          "variabilityKwh": 98.55
        },
        {
          "month": 9,
          "averageDailyKwh": 43.47,
          "monthlyKwh": 1304.02,
          "variabilityKwh": 98.44
        },
        {
          "month": 10,
          "averageDailyKwh": 34.9,
          "monthlyKwh": 1081.88,
          "variabilityKwh": 189.12
        },
        {
          "month": 11,
          "averageDailyKwh": 26.78,
          "monthlyKwh": 803.48,
          "variabilityKwh": 135.4
        },
        {
          "month": 12,
          "averageDailyKwh": 22.89,
          "monthlyKwh": 709.61,
          "variabilityKwh": 142.88
        }
      ]
    },
    {
      "city_id": "sofia",
      "city": "Sofia",
      "latitude": 42.6977,
      "longitude": 23.3219,
      "forecast": {
        "cityId": "sofia",
        "name": "Sofia",
        "lat": 42.6977,
        "lon": 23.3219,
        "timezone": "Europe/Sofia",
        "featured": true,
        "targetDate": "2026-08-05",
        "expectedKwh": 53.8,
        "lowKwh": 44.1,
        "highKwh": 58.5,
        "bestWindowStart": "2026-08-05T11:00:00+03:00",
        "bestWindowEnd": "2026-08-05T15:00:00+03:00",
        "confidence": "high",
        "fetchedAt": "2026-08-04T18:53:39.515401Z",
        "freshness": "fresh",
        "stale": false
      },
      "typical_annual_kwh": 13111.12,
      "typical_monthly": [
        {
          "month": 1,
          "averageDailyKwh": 23.02,
          "monthlyKwh": 713.49,
          "variabilityKwh": 118.92
        },
        {
          "month": 2,
          "averageDailyKwh": 30.62,
          "monthlyKwh": 857.5,
          "variabilityKwh": 117.46
        },
        {
          "month": 3,
          "averageDailyKwh": 35.68,
          "monthlyKwh": 1106.07,
          "variabilityKwh": 140.53
        },
        {
          "month": 4,
          "averageDailyKwh": 40.25,
          "monthlyKwh": 1207.5,
          "variabilityKwh": 147.1
        },
        {
          "month": 5,
          "averageDailyKwh": 40.64,
          "monthlyKwh": 1259.9,
          "variabilityKwh": 145.08
        },
        {
          "month": 6,
          "averageDailyKwh": 43.59,
          "monthlyKwh": 1307.72,
          "variabilityKwh": 117.42
        },
        {
          "month": 7,
          "averageDailyKwh": 48.09,
          "monthlyKwh": 1490.68,
          "variabilityKwh": 121.37
        },
        {
          "month": 8,
          "averageDailyKwh": 47.99,
          "monthlyKwh": 1487.83,
          "variabilityKwh": 117.93
        },
        {
          "month": 9,
          "averageDailyKwh": 40.83,
          "monthlyKwh": 1224.77,
          "variabilityKwh": 119.46
        },
        {
          "month": 10,
          "averageDailyKwh": 34.73,
          "monthlyKwh": 1076.52,
          "variabilityKwh": 190.5
        },
        {
          "month": 11,
          "averageDailyKwh": 25.43,
          "monthlyKwh": 762.78,
          "variabilityKwh": 140.43
        },
        {
          "month": 12,
          "averageDailyKwh": 19.88,
          "monthlyKwh": 616.38,
          "variabilityKwh": 129.45
        }
      ]
    },
    {
      "city_id": "varna",
      "city": "Varna",
      "latitude": 43.2141,
      "longitude": 27.9147,
      "forecast": {
        "cityId": "varna",
        "name": "Varna",
        "lat": 43.2141,
        "lon": 27.9147,
        "timezone": "Europe/Sofia",
        "featured": true,
        "targetDate": "2026-08-05",
        "expectedKwh": 54.1,
        "lowKwh": 46.9,
        "highKwh": 60.4,
        "bestWindowStart": "2026-08-05T12:00:00+03:00",
        "bestWindowEnd": "2026-08-05T16:00:00+03:00",
        "confidence": "high",
        "fetchedAt": "2026-08-04T18:53:39.575581Z",
        "freshness": "fresh",
        "stale": false
      },
      "typical_annual_kwh": 13453.45,
      "typical_monthly": [
        {
          "month": 1,
          "averageDailyKwh": 22.84,
          "monthlyKwh": 707.95,
          "variabilityKwh": 134.94
        },
        {
          "month": 2,
          "averageDailyKwh": 28.22,
          "monthlyKwh": 790.07,
          "variabilityKwh": 133.23
        },
        {
          "month": 3,
          "averageDailyKwh": 34.55,
          "monthlyKwh": 1071.05,
          "variabilityKwh": 133.94
        },
        {
          "month": 4,
          "averageDailyKwh": 42.14,
          "monthlyKwh": 1264.27,
          "variabilityKwh": 148.9
        },
        {
          "month": 5,
          "averageDailyKwh": 45.66,
          "monthlyKwh": 1415.53,
          "variabilityKwh": 82.16
        },
        {
          "month": 6,
          "averageDailyKwh": 47.83,
          "monthlyKwh": 1434.79,
          "variabilityKwh": 116.49
        },
        {
          "month": 7,
          "averageDailyKwh": 50.7,
          "monthlyKwh": 1571.69,
          "variabilityKwh": 107.45
        },
        {
          "month": 8,
          "averageDailyKwh": 51.62,
          "monthlyKwh": 1600.08,
          "variabilityKwh": 62.88
        },
        {
          "month": 9,
          "averageDailyKwh": 43.21,
          "monthlyKwh": 1296.33,
          "variabilityKwh": 107.07
        },
        {
          "month": 10,
          "averageDailyKwh": 31.72,
          "monthlyKwh": 983.23,
          "variabilityKwh": 153.9
        },
        {
          "month": 11,
          "averageDailyKwh": 22.24,
          "monthlyKwh": 667.12,
          "variabilityKwh": 114.13
        },
        {
          "month": 12,
          "averageDailyKwh": 21.01,
          "monthlyKwh": 651.34,
          "variabilityKwh": 154.8
        }
      ]
    },
    {
      "city_id": "burgas",
      "city": "Burgas",
      "latitude": 42.5065,
      "longitude": 27.4689,
      "forecast": {
        "cityId": "burgas",
        "name": "Burgas",
        "lat": 42.5065,
        "lon": 27.4689,
        "timezone": "Europe/Sofia",
        "featured": false,
        "targetDate": "2026-08-05",
        "expectedKwh": 53.6,
        "lowKwh": 47.1,
        "highKwh": 59.5,
        "bestWindowStart": "2026-08-05T12:00:00+03:00",
        "bestWindowEnd": "2026-08-05T16:00:00+03:00",
        "confidence": "high",
        "fetchedAt": "2026-08-04T18:53:39.606659Z",
        "freshness": "fresh",
        "stale": false
      },
      "typical_annual_kwh": 13364.75,
      "typical_monthly": [
        {
          "month": 1,
          "averageDailyKwh": 22.34,
          "monthlyKwh": 692.65,
          "variabilityKwh": 133.54
        },
        {
          "month": 2,
          "averageDailyKwh": 27.36,
          "monthlyKwh": 766.05,
          "variabilityKwh": 126.81
        },
        {
          "month": 3,
          "averageDailyKwh": 34.21,
          "monthlyKwh": 1060.44,
          "variabilityKwh": 123.55
        },
        {
          "month": 4,
          "averageDailyKwh": 41.74,
          "monthlyKwh": 1252.28,
          "variabilityKwh": 130.43
        },
        {
          "month": 5,
          "averageDailyKwh": 45.78,
          "monthlyKwh": 1419.23,
          "variabilityKwh": 84.89
        },
        {
          "month": 6,
          "averageDailyKwh": 47.26,
          "monthlyKwh": 1417.76,
          "variabilityKwh": 108.95
        },
        {
          "month": 7,
          "averageDailyKwh": 50.8,
          "monthlyKwh": 1574.75,
          "variabilityKwh": 105.61
        },
        {
          "month": 8,
          "averageDailyKwh": 51.36,
          "monthlyKwh": 1592.3,
          "variabilityKwh": 58.75
        },
        {
          "month": 9,
          "averageDailyKwh": 42.89,
          "monthlyKwh": 1286.77,
          "variabilityKwh": 107.8
        },
        {
          "month": 10,
          "averageDailyKwh": 31.57,
          "monthlyKwh": 978.65,
          "variabilityKwh": 173.62
        },
        {
          "month": 11,
          "averageDailyKwh": 22.99,
          "monthlyKwh": 689.72,
          "variabilityKwh": 134.54
        },
        {
          "month": 12,
          "averageDailyKwh": 20.46,
          "monthlyKwh": 634.18,
          "variabilityKwh": 155.14
        }
      ]
    },
    {
      "city_id": "ruse",
      "city": "Ruse",
      "latitude": 43.8487,
      "longitude": 25.9534,
      "forecast": {
        "cityId": "ruse",
        "name": "Ruse",
        "lat": 43.8487,
        "lon": 25.9534,
        "timezone": "Europe/Sofia",
        "featured": false,
        "targetDate": "2026-08-05",
        "expectedKwh": 53.6,
        "lowKwh": 46.6,
        "highKwh": 58.8,
        "bestWindowStart": "2026-08-05T12:00:00+03:00",
        "bestWindowEnd": "2026-08-05T16:00:00+03:00",
        "confidence": "high",
        "fetchedAt": "2026-08-04T18:53:39.648450Z",
        "freshness": "fresh",
        "stale": false
      },
      "typical_annual_kwh": 13053.95,
      "typical_monthly": [
        {
          "month": 1,
          "averageDailyKwh": 17.66,
          "monthlyKwh": 547.6,
          "variabilityKwh": 172.87
        },
        {
          "month": 2,
          "averageDailyKwh": 26.06,
          "monthlyKwh": 729.65,
          "variabilityKwh": 133.15
        },
        {
          "month": 3,
          "averageDailyKwh": 35.68,
          "monthlyKwh": 1105.94,
          "variabilityKwh": 145.47
        },
        {
          "month": 4,
          "averageDailyKwh": 43.07,
          "monthlyKwh": 1292.04,
          "variabilityKwh": 146.36
        },
        {
          "month": 5,
          "averageDailyKwh": 45.07,
          "monthlyKwh": 1397.15,
          "variabilityKwh": 107.89
        },
        {
          "month": 6,
          "averageDailyKwh": 47.35,
          "monthlyKwh": 1420.54,
          "variabilityKwh": 86.04
        },
        {
          "month": 7,
          "averageDailyKwh": 49.7,
          "monthlyKwh": 1540.76,
          "variabilityKwh": 107.2
        },
        {
          "month": 8,
          "averageDailyKwh": 49.12,
          "monthlyKwh": 1522.71,
          "variabilityKwh": 72.66
        },
        {
          "month": 9,
          "averageDailyKwh": 42.75,
          "monthlyKwh": 1282.47,
          "variabilityKwh": 104.54
        },
        {
          "month": 10,
          "averageDailyKwh": 33.8,
          "monthlyKwh": 1047.72,
          "variabilityKwh": 167.68
        },
        {
          "month": 11,
          "averageDailyKwh": 21.32,
          "monthlyKwh": 639.54,
          "variabilityKwh": 126.99
        },
        {
          "month": 12,
          "averageDailyKwh": 17.03,
          "monthlyKwh": 527.82,
          "variabilityKwh": 159.34
        }
      ]
    }
  ],
  "sources": {
    "tomorrow": {
      "weather": {
        "source_id": "OPEN_METEO",
        "name": "Open-Meteo weather forecast",
        "public_display_allowed": true,
        "requires_commercial_license": true,
        "terms_url": "https://open-meteo.com/en/terms",
        "pricing_url": "https://open-meteo.com/en/pricing"
      },
      "model": {
        "source_id": "GRIDPASSPORT_PV_PUBLIC_V1",
        "name": "GridPassport public PV forecast model",
        "description": "Weather-based physical PV estimate with public-safe inputs."
      },
      "attribution": {
        "text": "Weather forecast by Open-Meteo, PV estimate by GridPassport.",
        "transformation_notes": "GridPassport projects irradiance onto the configured PV array and applies public lead-magnet loss assumptions."
      }
    },
    "typical_year": {
      "name": "European Commission Joint Research Centre PVGIS 5.3",
      "url": "https://joint-research-centre.ec.europa.eu/photovoltaic-geographical-information-system-pvgis_en",
      "api": "https://re.jrc.ec.europa.eu/api/v5_3/PVcalc",
      "method": "Monthly average fixed-system output calculated from a multi-year solar radiation and climate series."
    }
  },
  "methodology_url": "https://gridpassport.com/solar-forecast/methodology/"
}