Skip to main content
POST
Current Forecast Operation

Body

application/json
location
object
required

Geographic point to query forecasts for

metrics
enum<string>[]
required

Metrics requested for the current weather endpoint. Allowed values: WEATHER_ICON, TEMPERATURE, APPARENT_TEMPERATURE, HUMIDITY, CLOUD_COVER, WIND_SPEED, WIND_GUSTS, WIND_DIRECTION, SNOWFALL, PRECIPITATION

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:
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

Current weather 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: