---
title: "Solar PV Energy Forecast"
method: GET
path: "/solar.json"
tags: ["Solar"]
---

# Solar PV Energy Forecast

`GET /solar.json`

## Request

- Base URL: `https://api.weatherapi.com/v1`
- URL: `https://api.weatherapi.com/v1/solar.json`
- Auth: API key in query parameter `key`

Returns an hourly and daily power and energy forecast for a solar PV system (up to 14 days; hourly to day 5, 3-hourly after). Available on Business plan and above; keys on other plans get 403 / error 2009. Invalid parameters return 400 with error 1010 (capacity_kw) or 1011 (other solar parameters).

## Query parameters

- `key` string, required
- `q` string, required
- `days` integer
- `capacity_kw` number, required
- `tilt` number
- `azimuth` number
- `tracking` 'fixed' | 'single_axis' | 'dual_axis'
- `module_type` 'standard' | 'premium' | 'thin_film'
- `losses` number
- `inverter_kw` number
- `inverter_eff` number
- `albedo` number

## Response `200`

Solar PV energy forecast

- SolarResponse
  - `location` Location: Location metadata returned with every weather response.
    - `name` string: Location name
    - `region` string: Region or state
    - `country` string: Country name
    - `lat` number, float: Latitude
    - `lon` number, float: Longitude
    - `tz_id` string: IANA timezone ID, e.g. Europe/London
    - `localtime_epoch` integer: Local time as Unix epoch
    - `localtime` string: Local date and time string
  - `system` SolarSystem: Settings used for the calculation, including any defaults applied.
    - `capacity_kw` number: Array (DC) size in kWp
    - `tilt` number: Panel tilt in degrees
    - `azimuth` number: Panel azimuth in degrees clockwise from north (180 = south)
    - `tracking` 'fixed' | 'single_axis' | 'dual_axis'
    - `module_type` 'standard' | 'premium' | 'thin_film'
    - `temp_coefficient` number: Power temperature coefficient %/°C
    - `losses` number: System losses %
    - `inverter_kw` number: Inverter AC rating kW
    - `inverter_eff` number: Inverter efficiency %
    - `albedo` number: Ground reflectance 0-1
  - `forecast` object
    - `forecastday` SolarForecastDay[]
      - `date` string, date
      - `date_epoch` integer
      - `day` SolarDay
        - `energy_kwh` number: Total AC energy for the day kWh
        - `energy_dc_kwh` number: Total DC energy for the day kWh
        - `peak_power_kw` number: Highest AC power kW
        - `peak_sun_hours` number: Equivalent full-sun hours on the panel plane
        - `performance_ratio` number: Performance ratio %
        - `ghi_kwh_m2` number: Global horizontal irradiation kWh/m²
        - `poa_kwh_m2` number: Plane-of-array irradiation kWh/m²
      - `hour` SolarHour[]
        - `time_epoch` integer: Period end, unix time (UTC)
        - `time` string: Period end, local time yyyy-MM-dd HH:mm
        - `period_hours` number: Period length in hours (1 to day 5, 3 after)
        - `ghi` number: Global horizontal irradiance W/m²
        - `dni` number: Direct normal irradiance W/m²
        - `dhi` number: Diffuse horizontal irradiance W/m²
        - `poa_global` number: Total plane-of-array irradiance W/m²
        - `poa_direct` number: Direct plane-of-array irradiance W/m²
        - `poa_diffuse` number: Sky diffuse plane-of-array irradiance W/m²
        - `poa_ground` number: Ground-reflected plane-of-array irradiance W/m²
        - `sun_elevation` number: Sun elevation degrees
        - `sun_azimuth` number: Sun azimuth degrees from north
        - `angle_of_incidence` number: Angle of incidence on the panel degrees
        - `temp_c` number: Air temperature °C
        - `wind_kph` number: Wind speed kph
        - `cell_temp_c` number: Cell temperature °C
        - `power_dc_kw` number: Average DC power kW
        - `power_ac_kw` number: Average AC power kW
        - `energy_kwh` number: AC energy for the period kWh
        - `clipped_kwh` number: Energy lost to inverter clipping kWh
        - `snow_cover` 0 | 1: 1 = panels likely covered by snow

## Other responses

- `400`: Bad request — invalid parameter or location not found.
- `401`: Unauthorized — API key missing or invalid.
- `403`: Forbidden — API key quota exceeded, disabled, or plan does not include this resource.

## Changes

- **2026-10-04** `de9b5839de7d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weatherapi/apis/weatherapi-com/changes/solar.json/get.md)

---

[API](https://skmtc.dev/weatherapi/apis/weatherapi-com.md) - [All operations](https://skmtc.dev/weatherapi/apis/weatherapi-com/llms.txt) - [OpenAPI document](https://skmtc.dev/weatherapi/apis/weatherapi-com/revisions/26c06925a7e0?raw)