One Call API 2.5
Loading...
One Call API 2.5
The One Call API 2.5 has been deprecated on June 2024. Please read the detailed guide for transitioning to the more advanced One Call API 4.0 which includes several useful upgrades like 47+ years of history archive, daily aggregation and human-readable daily summary in comparison with the One Call API 2.5 version. Read more about One Call API 4.0 on the product documentation page and FAQ.
Make just one API call and get all your essential weather data for a specific location with our new OpenWeather One Call API 2.5. Easy migration from the Dark Sky API.
The One Call API 2.5 provides the following weather data for any geographical coordinates:
Current and forecast weather data
To get access to current weather, minute forecast for 1 hour, hourly forecast for 48 hours, daily forecast for 7 days and government weather alerts, please use this section of the documentation.
If you are interested in historical weather data, please read the "Historical weather data" section.
https://api.openweathermap.org/data/2.5/onecall?lat={lat}&lon={lon}&exclude={part}&appid={API key}Parameters | ||
|---|---|---|
| required | Geographical coordinates (latitude, longitude) |
| required | Your unique API key (you can always find it on your account page under the "API key" tab) |
| optional | By using this parameter you can exclude some parts of the weather data from the API response. It should be a comma-delimited list (without spaces). Available values: |
| optional | Units of measurement. |
| optional | You can use the |
https://api.openweathermap.org/data/2.5/onecall?lat=33.44&lon=-94.04&exclude=hourly,daily&appid={API key}To view the API response, expand the example by clicking the triangle.lat Geographical coordinates of the location (latitude)lon Geographical coordinates of the location (longitude)timezone Timezone name for the requested locationtimezone_offset Shift in seconds from UTCcurrent Current weather data API responsecurrent.dt Current time, Unix, UTCcurrent.sunrise Sunrise time, Unix, UTCcurrent.sunset Sunset time, Unix, UTCcurrent.temp Temperature. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedcurrent.feels_like Temperature. This temperature parameter accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.current.pressure Atmospheric pressure on the sea level, hPacurrent.humidity Humidity, %current.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.current.clouds Cloudiness, %current.uvi Current UV indexcurrent.visibility Average visibility, metres. The maximum value of the visibility is 10kmcurrent.wind_speed Wind speed. Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units usedcurrent.wind_gust (where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units usedcurrent.wind_deg Wind direction, degrees (meteorological)current.raincurrent.rain.1h (where available) Rain, mm/hcurrent.snowcurrent.snow.1h (where available) Precipitation, mm/hcurrent.weathercurrent.weather.id Weather condition idcurrent.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 languagecurrent.weather.icon Weather icon id. How to get iconsminutely Minute forecast weather data API responseminutely.dt Time of the forecasted data, unix, UTCminutely.precipitation Precipitation, mm/hhourly Hourly forecast weather data API responsehourly.dt Time of the forecasted data, Unix, UTChourly.temp Temperature. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedhourly.feels_like Temperature. This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.hourly.pressure Atmospheric pressure on the sea level, hPahourly.humidity Humidity, %hourly.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.hourly.uvi UV indexhourly.clouds Cloudiness, %hourly.visibility Average visibility, metres. The maximum value of the visibility is 10kmhourly.wind_speed Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour.How to change units usedhourly.wind_gust (where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units usedchourly.wind_deg Wind direction, degrees (meteorological)hourly.pop Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%hourly.rainhourly.rain.1h (where available) Rain, mm/hhourly.snowhourly.snow.1h (where available) Precipitation, mm/hhourly.weatherhourly.weather.id Weather condition idhourly.weather.main Group of weather parameters (Rain, Snow, Extreme etc.)hourly.weather.description Weather condition within the group (full list of weather conditions). Get the output in your languagehourly.weather.icon Weather icon id. How to get iconsdaily Daily forecast weather data API responsedaily.dt Time of the forecasted data, Unix, UTCdaily.sunrise Sunrise time, Unix, UTCdaily.sunset Sunset time, Unix, UTCdaily.moonrise The time of when the moon rises for this day, Unix, UTCdaily.moonset The time of when the moon sets for this day, Unix, UTCdaily.moon_phase Moon phase. 0 and 1 are 'new moon', 0.25 is 'first quarter moon', 0.5 is 'full moon' and 0.75 is 'last quarter moon'. The periods in between are called 'waxing crescent', 'waxing gibous', 'waning gibous', and 'waning crescent', respectively.daily.temp Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units useddaily.temp.morn Morning temperature.daily.temp.day Day temperature.daily.temp.eve Evening temperature.daily.temp.night Night temperature.daily.temp.min Min daily temperature.daily.temp.max Max daily temperature.daily.feels_like This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units useddaily.feels_like.morn Morning temperature.daily.feels_like.day Day temperature.daily.feels_like.eve Evening temperature.daily.feels_like.night Night temperature.daily.pressure Atmospheric pressure on the sea level, hPadaily.humidity Humidity, %daily.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.daily.wind_speed Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddaily.wind_gust (where available) Wind gust. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddaily.wind_deg Wind direction, degrees (meteorological)daily.clouds Cloudiness, %daily.uvi The maximum value of UV index for the daydaily.pop Probability of precipitation. The values of the parameter vary between 0 and 1, where 0 is equal to 0%, 1 is equal to 100%daily.rain (where available) Rain volume, mmdaily.snow (where available) Snow volume, mmdaily.weatherdaily.weather.id Weather condition iddaily.weather.main Group of weather parameters (Rain, Snow, Extreme etc.)daily.weather.description Weather condition within the group (full list of weather conditions). Get the output in your languagedaily.weather.icon Weather icon id. How to get iconsalerts National weather alerts data from major national weather warning systemsalerts.sender_name Name of the alert source. Please read here the full list of alert sourcesalerts.event Alert event namealerts.start Date and time of the start of the alert, Unix, UTCalerts.end Date and time of the end of the alert, Unix, UTCalerts.description Description of the alertalerts.tags Type of severe weatherNational weather alerts are provided in English by default. Please note that some agencies provide the alert’s description only in a local language.