Skip to main content
POST
/
v1
/
forecasts
/
daily
Daily Forecast Operation
curl --request POST \
  --url https://api.iklim.co/v1/forecasts/daily \
  --header 'Content-Type: application/json' \
  --data '
{
  "location": {
    "lng": 32.857358,
    "lat": 39.93504
  },
  "metrics": [
    "TEMPERATURE_MAX",
    "TEMPERATURE_MIN"
  ],
  "forecastDays": 7,
  "startTime": 1746454091000
}
'
{ "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 daily forecast endpoint. Allowed values: WEATHER_ICON, TEMPERATURE_AVG, TEMPERATURE_MIN, TEMPERATURE_MAX, APPARENT_TEMPERATURE_AVG, APPARENT_TEMPERATURE_MIN, APPARENT_TEMPERATURE_MAX, HUMIDITY_AVG, HUMIDITY_MIN, HUMIDITY_MAX, CLOUD_COVER_AVG, CLOUD_COVER_MIN, CLOUD_COVER_MAX, WIND_SPEED_AVG, WIND_SPEED_MIN, WIND_SPEED_MAX, WIND_GUSTS_AVG, WIND_GUSTS_MIN, WIND_GUSTS_MAX, WIND_DIRECTION, SNOWFALL, PRECIPITATION, PRECIPITATION_PROBABILITY_AVG, PRECIPITATION_PROBABILITY_MIN, PRECIPITATION_PROBABILITY_MAX, VISIBILITY_AVG, VISIBILITY_MIN, VISIBILITY_MAX, REF_EVAPORATION_TRANSPIRATION_ET0, REF_EVAPORATION_TRANSPIRATION_ET0_SUM, DEW_POINT_AVG, DEW_POINT_MIN, DEW_POINT_MAX, SHORTWAVE_RADIATION_SUM

Minimum array length: 1
Available options:
WEATHER_ICON,
TEMPERATURE,
TEMPERATURE_AVG,
TEMPERATURE_MIN,
TEMPERATURE_MAX,
APPARENT_TEMPERATURE,
APPARENT_TEMPERATURE_AVG,
APPARENT_TEMPERATURE_MIN,
APPARENT_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,
SNOWFALL,
PRECIPITATION,
PRECIPITATION_PROBABILITY,
PRECIPITATION_PROBABILITY_AVG,
PRECIPITATION_PROBABILITY_MIN,
PRECIPITATION_PROBABILITY_MAX,
REF_EVAPORATION_TRANSPIRATION_ET0,
REF_EVAPORATION_TRANSPIRATION_ET0_SUM,
DEW_POINT,
DEW_POINT_AVG,
DEW_POINT_MIN,
DEW_POINT_MAX,
SOIL_TEMPERATURE,
SOIL_MOISTURE,
GLOBAL_TILTED_RADIATION_GTI,
DIRECT_NORMAL_IRRADIANCE_DNI,
SHORTWAVE_SOLAR_RADIATION_GHI,
SHORTWAVE_RADIATION_SUM,
VISIBILITY,
VISIBILITY_AVG,
VISIBILITY_MIN,
VISIBILITY_MAX
Example:
["TEMPERATURE_MAX", "TEMPERATURE_MIN"]
​
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

Response

Daily 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"
]