One Call API

Make only one API call and get all essential weather data for some specific location with our new OpenWeather One Call API.

One Call API provides the following weather data for any geographical coordinate:

  • Current weather

  • Minute forecast for 1 hour

  • Hourly forecast for 48 hours

  • Daily forecast for 7 days

  • Historical weather data for 5 previous days

Current and forecasts weather data

To get access to current weather, minute forecast for 1 hour, hourly forecast for 48 hours and daily forecast for 7 days, please use this section of the documentation.
If you are interested in historical weather data, please read the "Historical weather data" section.

How to make an API call

API call:
https://api.openweathermap.org/data/2.5/onecall?lat={lat}&lon={lon}&exclude={part}&appid={YOUR API KEY}

lat, lon geographical coordinates (latitude, longitude)
API key unique API key (you can always find it on the account page, on the "API key" tab)
part (optional parameter) by using this parameter you can exclude some parts of weather data from the API response. The value parts should be a comma-delimited list (without spaces). Available values:

  • current
  • minutely
  • hourly
  • daily

Please note that the minute forecast is only available for certain regions.

Example of API call:
https://api.openweathermap.org/data/2.5/onecall?lat=33.441792&lon=-94.037689&
exclude=hourly,daily&appid={YOUR API KEY}

Example of API response

  {
  "lat": 33.44,
  "lon": -94.04,
  "timezone": "America/Chicago",
  "timezone_offset": -18000,
  "current": {
    "dt": 1588935779,
    "sunrise": 1588936856,
    "sunset": 1588986260,
    "temp": 16.75,
    "feels_like": 16.07,
    "pressure": 1009,
    "humidity": 93,
    "dew_point": 15.61,
    "uvi": 8.97,
    "clouds": 90,
    "visibility": 12874,
    "wind_speed": 3.6,
    "wind_deg": 280,
    "weather": [
      {
        "id": 501,
        "main": "Rain",
        "description": "moderate rain",
        "icon": "10n"
      },
      {
        "id": 200,
        "main": "Thunderstorm",
        "description": "thunderstorm with light rain",
        "icon": "11n"
      }
    ],
    "rain": {
      "1h": 2.79
    }
  },
   "minutely": [
    {
      "dt": 1588935780,
      "precipitation": 2.789
    },
    ...
  },
  "hourly": [
      {
      "dt": 1588935600,
      "temp": 16.75,
      "feels_like": 13.93,
      "pressure": 1009,
      "humidity": 93,
      "dew_point": 15.61,
      "clouds": 90,
      "wind_speed": 6.66,
      "wind_deg": 203,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10n"
        }
      ],
      "rain": {
        "1h": 2.92
      }
    },
    ...
  }
    "daily": [
        {
      "dt": 1588960800,
      "sunrise": 1588936856,
      "sunset": 1588986260,
      "temp": {
        "day": 22.49,
        "min": 10.96,
        "max": 22.49,
        "night": 10.96,
        "eve": 18.45,
        "morn": 18.14
      },
      "feels_like": {
        "day": 18.72,
        "night": 6.53,
        "eve": 16.34,
        "morn": 16.82
      },
      "pressure": 1014,
      "humidity": 60,
      "dew_point": 14.35,
      "wind_speed": 7.36,
      "wind_deg": 342,
      "weather": [
        {
          "id": 502,
          "main": "Rain",
          "description": "heavy intensity rain",
          "icon": "10d"
        }
      ],
      "clouds": 68,
      "rain": 15.38,
      "uvi": 8.97
    },
    ...
    }
                        

Parameters of API response

  • lat Geographical coordinates of the location (latitude)
  • lon Geographical coordinates of the location (longitude)
  • timezone Timezone name for the requested location
  • timezone_offset Shift in seconds from UTC

  • current Current weather data API response
    • current.dt Current time, unix, UTC
    • current.sunrise Sunrise time, unix, UTC
    • current.sunset Sunset time, unix, UTC
    • current.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. How to change units format
    • current.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • current.pressure Atmospheric pressure on the sea level, hPa
    • current.humidity Humidity, %
    • current.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • current.clouds Cloudiness, %
    • current.uvi UV index
    • current.visibility Average visibility, meters
    • current.wind_speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • current.wind_gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • current.wind_deg Wind direction, degrees (meteorological)
    • current.rain Precipitation volume, mm
      • current.rain.1h Rain volume for last hour, mm
    • current.snow Snow volume, mm
      • current.snow.1h Snow volume for last hour
    • current.weather (more info Weather condition codes)
      • current.weather.id Weather condition id
      • current.weather.main Group of weather parameters (Rain, Snow, Extreme etc.)
      • current.weather.description Weather condition within the group (full list of weather conditions). Get the output in your language
      • current.weather.icon Weather icon id. How to get icons

  • minutely Minute forecast weather data API response Available for the US (other countries are coming soon)
    • minutely.dt Time of the forecasted data, unix, UTC
    • minutely.precipitation Precipitation volume, mm

  • hourly Hourly forecast weather data API response
    • hourly.dt Time of the forecasted data, unix, UTC
    • hourly.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. How to change units format
    • hourly.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • hourly.pressure Atmospheric pressure on the sea level, hPa
    • hourly.humidity Humidity, %
    • hourly.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • hourly.clouds Cloudiness, %
    • hourly.visibility Average visibility, meters
    • hourly.wind_speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.How to change units format
    • hourly.wind_gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • chourly.wind_deg Wind direction, degrees (meteorological)
    • hourly.rain Precipitation volume, mm
      • hourly.rain.1h Rain volume for last hour, mm
    • hourly.snow Snow volume, mm
      • hourly.snow.1h Snow volume for last hour
    • hourly.weather (more info Weather condition codes)

  • daily Daily forecast weather data API response
    • daily.dt Time of the forecasted data, unix, UTC
    • daily.sunrise Sunrise time, unix, UTC
    • daily.sunset Sunset time, unix, UTC
    • daily.temp
      • daily.temp.morn Morning temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. How to change units format
      • daily.temp.day Day temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
      • daily.temp.eve Evening temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
      • daily.temp.night Night temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
      • daily.temp.min Min daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
      • daily.temp.max Max daily temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • daily.feels_like
      • daily.feels_like.morn Morning temperature.Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. How to change units format
      • daily.feels_like.day Day temperature.Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
      • daily.feels_like.eve Evening temperature.Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
      • daily.feels_like.night Night temperature.Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • daily.pressure Atmospheric pressure on the sea level, hPa
    • daily.humidity Humidity, %
    • daily.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • daily.wind_speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • daily.wind_gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • daily.wind_deg Wind direction, degrees (meteorological)
    • daily.clouds Cloudiness, %
    • daily.uvi Midday UV index
    • daily.visibility Average visibility, meters
    • daily.rain Precipitation volume, mm
    • daily.snow Snow volume, mm
    • daily.weather (more info Weather condition codes)

Historical weather data

To get access to historical weather data for the 5 previous days, please use this section of the documentation.
If you are interested in current and forecast weather data, please read the "Current and forecast weather data" section.

How to make an API call

API call:
https://api.openweathermap.org/data/2.5/onecall/timemachine?lat={lat}&lon={lon}&dt={time}&appid={YOUR API KEY}

lat, lon geographical coordinates (latitude, longitude)
dt date from the 5 previous days (unix time, UTC time zone), e.g. dt=1586468027
API key unique API key (you can always find it on the account page, on the "API key" tab)

Please note that in order to get historical data for the last 5 days, you need to make 5 API calls (1 call for each day).

Example of API call:
http://api.openweathermap.org/data/2.5/onecall/timemachine?lat=60.99&lon=30.9&dt=1586468027&appid={YOUR API KEY}

Example of API response

  {
  "lat": 60.99,
  "lon": 30.9,
  "timezone": "Europe/Moscow",
  "timezone_offset": 10800"
  "current": {
    "dt": 1586468027,
    "sunrise": 1586487424,
    "sunset": 1586538297,
    "temp": 274.31,
    "feels_like": 269.79,
    "pressure": 1006,
    "humidity": 72,
    "dew_point": 270.21,
    "clouds": 0,
    "visibility": 10000,
    "wind_speed": 3,
    "wind_deg": 260,
    "weather": [
      {
        "id": 800,
        "main": "Clear",
        "description": "clear sky",
        "icon": "01n"
      }
    ]
  },
  "hourly": [
    {
      "dt": 1586390400,
      "temp": 278.41,
      "feels_like": 269.43,
      "pressure": 1006,
      "humidity": 65,
      "dew_point": 272.46,
      "clouds": 0,
      "wind_speed": 9.83,
      "wind_deg": 60,
      "wind_gust": 15.65,
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01n"
        }
      ]
    },    ...
    }
                        

Parameters of API response

  • lat Geographical coordinates of the location (latitude)
  • lon Geographical coordinates of the location (longitude)
  • timezone Timezone name for the requested location
  • timezone_offset Shift in seconds from UTC

  • current Data point dt refers to the requested time, rather than the current time
    • current.dt Requested time, unix, UTC
    • current.sunrise Sunrise time, unix, UTC
    • current.sunset Sunset time, unix, UTC
    • current.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. How to change units format
    • current.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • current.pressure Atmospheric pressure on the sea level, hPa
    • current.humidity Humidity, %
    • current.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • current.clouds Cloudiness, %
    • current.uvi Midday UV index
    • current.visibility Average visibility, meters
    • current.wind_speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • current.wind_gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • current.wind_deg Wind direction, degrees (meteorological)
    • current.rain Precipitation volume, mm
    • current.snow Snow volume, mm
    • current.weather (more info Weather condition codes)
      • current.weather.id Weather condition id
      • current.weather.main Group of weather parameters (Rain, Snow, Extreme etc.)
      • current.weather.description Weather condition within the group (full list of weather conditions). Get the output in your language
      • current.weather.icon Weather icon id. How to get icons

  • hourly Data block contains hourly historical data starting at 00:00 of the requested day and continues until 23:59 of the same day (UTC time)
    • hourly.dt Time of historical data, unix, UTC
    • hourly.temp Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit. How to change units format
    • hourly.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • hourly.pressure Atmospheric pressure on the sea level, hPa
    • hourly.humidity Humidity, %
    • hourly.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
    • hourly.clouds Cloudiness, %
    • hourly.visibility Average visibility, meters
    • hourly.wind_speed Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.How to change units format
    • hourly.wind_gust Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour. How to change units format
    • chourly.wind_deg Wind direction, degrees (meteorological)
    • hourly.rain Precipitation volume, mm
    • hourly.snow Snow volume, mm
    • hourly.weather (more info Weather condition codes)

Other features

Units format

Standard, metric, and imperial units are available. List of all API parameters with available units

API call:
http://api.openweathermap.org/data/2.5/onecall?lat={lat}&lon={lon}&units={units}
Parameters:

units metric, imperial. When you do not use units parameter, format is Standard by default.

Temperature is available in Fahrenheit, Celsius and Kelvin units.

  • For temperature in Fahrenheit use units=imperial
  • For temperature in Celsius use units=metric
  • Temperature in Kelvin is used by default, no need to use units parameter in API call
Examples of API calls:

Standard (default)
api.openweathermap.org/data/2.5/onecall?lat=30.489772&lon=-99.771335

Metric api.openweathermap.org/data/2.5/onecall?lat=30.489772&lon=-99.771335&units=metric

Imperial api.openweathermap.org/data/2.5/onecall?lat=30.489772&lon=-99.771335&units=imperial

Multilingual support

You can use lang parameter to get the output in your language.
Translation is applied for the description field.

API call:
http://api.openweathermap.org/data/2.5/onecall?lat={lat}&lon={lon}&lang={lang}
Parameters:
lang language code
Examples of API calls:
http://api.openweathermap.org/data/2.5/onecall?lat=30.489772&lon=-99.771335&lang=zh_cn

We support the following languages that you can use with the corresponded lang values:

# Language code Language
1 af Afrikaans
2 al Albanian
3 ar Arabic
4 az Azerbaijani
5 bg Bulgarian
6 ca Catalan
7 cz Czech
8 da Danish
9 de German
10 el Greek
11 en English
12 eu Basque
13 fa Persian (Farsi)
14 fi Finnish
15 fr French
16 gl Galician
17 he Hebrew
18 hi Hindi
19 hr Croatian
20 hu Hungarian
21 id Indonesian
22 it Italian
23 ja Japanese
24 kr Korean
25 la Latvian
26 lt Lithuanian
27 mk Macedonian
28 no Norwegian
29 nl Dutch
30 pl Polish
31 pt Portuguese
32 pt_br Português Brasil
33 ro Romanian
34 ru Russian
35 sv, se Swedish
36 sk Slovak
37 sl Slovenian
38 sp, es Spanish
39 sr Serbian
40 th Thai
41 tr Turkish
42 ua, uk Ukrainian
43 vi Vietnamese
44 zh_cn Chinese Simplified
45 zh_tw Chinese Traditional
46 zu Zulu