Skip to main content
POST
/
v1
/
forecasts
/
hourly
Hourly Forecast Operation
curl --request POST \
  --url https://api.iklim.co/v1/forecasts/hourly \
  --header 'Content-Type: application/json' \
  --data '
{
  "location": {
    "lng": 32.857358,
    "lat": 39.93504
  },
  "metrics": [
    "TEMPERATURE",
    "WIND_SPEED"
  ],
  "forecastDays": 7,
  "startTime": 1746454091000,
  "solarPanelTiltForRadiation": 45,
  "solarPanelAzimuthForRadiation": 0
}
'
{
  "location": {
    "lng": 32.857358,
    "lat": 39.93504
  },
  "timezone": "Europe/Istanbul",
  "elevation": 897.5,
  "weatherIconUrlBase": "https://api-test.iklim.co/v1/weather-icons",
  "metricForecasts": [
    {
      "metric": "TEMPERATURE",
      "unit": "°C",
      "forecasts": [
        {
          "time": "2025-04-14T16:58:22Z",
          "isDay": true,
          "value": 23.5,
          "icon": "sunny"
        }
      ]
    }
  ],
  "warnings": [
    "The provided metric is not valid for this request: TEMPERATURE_SUM"
  ]
}

Body

application/json
​
location
object
required

Geographic point to query forecasts for

​
metrics
enum<string>[]
required

Metrics requested for the hourly forecast endpoint. Allowed values: WEATHER_ICON, TEMPERATURE, HUMIDITY, CLOUD_COVER, WIND_SPEED, WIND_GUSTS, WIND_DIRECTION, PRECIPITATION, PRECIPITATION_PROBABILITY, REF_EVAPORATION_TRANSPIRATION_ET0, DEV_POINT, SOIL_TEMPERATURE, SOIL_MOISTURE, GLOBAL_TILED_RADIATION_GTI, DIRECT_NORMAL_IRRADIANCE_DNI, SHORTWAVE_SOLAR_RADIATION_GHI

Minimum array length: 1
Available options:
WEATHER_ICON,
TEMPERATURE,
TEMPERATURE_AVG,
TEMPERATURE_MIN,
TEMPERATURE_MAX,
HUMIDITY,
HUMIDITY_AVG,
HUMIDITY_MIN,
HUMIDITY_MAX,
CLOUD_COVER,
CLOUD_COVER_AVG,
CLOUD_COVER_MIN,
CLOUD_COVER_MAX,
WIND_SPEED,
WIND_SPEED_AVG,
WIND_SPEED_MIN,
WIND_SPEED_MAX,
WIND_GUSTS,
WIND_GUSTS_AVG,
WIND_GUSTS_MIN,
WIND_GUSTS_MAX,
WIND_DIRECTION,
PRECIPITATION,
PRECIPITATION_PROBABILITY,
PRECIPITATION_PROBABILITY_AVG,
PRECIPITATION_PROBABILITY_MIN,
PRECIPITATION_PROBABILITY_MAX,
REF_EVAPORATION_TRANSPIRATION_ET0,
REF_EVAPORATION_TRANSPIRATION_ET0_SUM,
DEV_POINT,
DEV_POINT_AVG,
DEV_POINT_MIN,
DEV_POINT_MAX,
SOIL_TEMPERATURE,
SOIL_MOISTURE,
GLOBAL_TILED_RADIATION_GTI,
DIRECT_NORMAL_IRRADIANCE_DNI,
SHORTWAVE_SOLAR_RADIATION_GHI,
SHORTWAVE_RADIATION_SUM
Example:
["TEMPERATURE", "WIND_SPEED"]
​
forecastDays
integer<int32>

Maximum number of days to return (1-14)

Required range: 1 <= x <= 14
Example:

7

​
startTime
integer<int64>

Optional epoch milliseconds that mark the start of the forecast horizon

Example:

1746454091000

​
solarPanelTiltForRadiation
number<double>

Panel tilt angle in degrees used to calculate solar radiation metrics

Example:

45

​
solarPanelAzimuthForRadiation
number<double>

Panel azimuth angle in degrees used to calculate solar radiation metrics

Example:

0

Response

Hourly forecast data successfully retrieved.

​
location
object

Location resolved for the forecast

​
timezone
string

IANA timezone identifier used for timestamps

Example:

"Europe/Istanbul"

​
elevation
number<double>

Elevation of the requested location in meters

Example:

897.5

​
weatherIconUrlBase
string

Base URL that can be used to fetch weather icons

Example:

"https://api-test.iklim.co/v1/weather-icons"

​
metricForecasts
object[]

Metric forecasts returned in the response

​
warnings
string[]

Informational warnings returned for the request

Example:
[
  "The provided metric is not valid for this request: TEMPERATURE_SUM"
]