{
"lat":33.44,
"lon":-94.04,
"timezone":"America/Chicago",
"timezone_offset":-18000,
"current":{
"dt":1684929490,
"sunrise":1684926645,
"sunset":1684977332,
"temp":292.55,
"feels_like":292.87,
"pressure":1014,
"humidity":89,
"dew_point":290.69,
"uvi":0.16,
"clouds":53,
"visibility":10000,
"wind_speed":3.13,
"wind_deg":93,
"wind_gust":6.71,
"weather":[
{
"id":803,
"main":"Clouds",
"description":"broken clouds",
"icon":"04d"
}
]
},
"minutely":[
{
"dt":1684929540,
"precipitation":0
},
...
],
"hourly":[
{
"dt":1684926000,
"temp":292.01,
"feels_like":292.33,
"pressure":1014,
"humidity":91,
"dew_point":290.51,
"uvi":0,
"clouds":54,
"visibility":10000,
"wind_speed":2.58,
"wind_deg":86,
"wind_gust":5.88,
"weather":[
{
"id":803,
"main":"Clouds",
"description":"broken clouds",
"icon":"04n"
}
],
"pop":0.15
},
...
],
"daily":[
{
"dt":1684951200,
"sunrise":1684926645,
"sunset":1684977332,
"moonrise":1684941060,
"moonset":1684905480,
"moon_phase":0.16,
"summary":"Expect a day of partly cloudy with rain",
"temp":{
"day":299.03,
"min":290.69,
"max":300.35,
"night":291.45,
"eve":297.51,
"morn":292.55
},
"feels_like":{
"day":299.21,
"night":291.37,
"eve":297.86,
"morn":292.87
},
"pressure":1016,
"humidity":59,
"dew_point":290.48,
"wind_speed":3.98,
"wind_deg":76,
"wind_gust":8.92,
"weather":[
{
"id":500,
"main":"Rain",
"description":"light rain",
"icon":"10d"
}
],
"clouds":92,
"pop":0.47,
"rain":0.15,
"uvi":9.23
},
...
],
"alerts": [
{
"sender_name": "NWS Philadelphia - Mount Holly (New Jersey, Delaware, Southeastern Pennsylvania)",
"event": "Small Craft Advisory",
"start": 1684952747,
"end": 1684988747,
"description": "...SMALL CRAFT ADVISORY REMAINS IN EFFECT FROM 5 PM THIS\nAFTERNOON TO 3 AM EST FRIDAY...\n* WHAT...North winds 15 to 20 kt with gusts up to 25 kt and seas\n3 to 5 ft expected.\n* WHERE...Coastal waters from Little Egg Inlet to Great Egg\nInlet NJ out 20 nm, Coastal waters from Great Egg Inlet to\nCape May NJ out 20 nm and Coastal waters from Manasquan Inlet\nto Little Egg Inlet NJ out 20 nm.\n* WHEN...From 5 PM this afternoon to 3 AM EST Friday.\n* IMPACTS...Conditions will be hazardous to small craft.",
"tags": [
]
},
...
]
One Call API 3.0
Product concept
Get essential weather data, short-term and long-term forecasts and aggregated weather data is easy with our OpenWeather One Call API 3.0. This product designed to ensure easy migration from the Dark Sky API.
One Call API 3.0 contains 4 endpoints and provides access to various data:
-
Current weather and forecasts:
- minute forecast for 1 hour
- hourly forecast for 48 hours
- daily forecast for 8 days
- Weather data for any timestamp for 45+ years historical archive and 4 days ahead forecast
- Daily aggregation of weather data for 45+ years archive and 1.5 years ahead forecast
- Weather overview with a human-readable weather summary for today and tomorrow's forecast, utilizing OpenWeather AI technologies
One Call API 3.0 is based on the proprietary OpenWeather Model and is updated every 10 minutes. Thus, in order to receive the most accurate and up-to-date weather data, we recommend you request One Call API 3.0 every 10 minutes.
Please note, that One Call API 3.0 is included in the "One Call by Call" subscription only. This separate subscription includes 1,000 calls/day for free and allows you to pay only for the number of API calls made to this product. Please note, that you do not need to subscribe to any other OpenWeather subscription plans to get access to the One Call API 3.0. Please find more details on the pricing page and FAQ.
How to start
- Sign up to OpenWeather service in case you haven't got your OpenWeather API key yet.
- Follow the pricing page to learn details about the price.
One Call API 3.0 is included in the separate subscription only and allows you to pay only for the number of API calls made to this product. Please find more details on the pricing page.
- Once you subscribe to One call API 3.0, 2000 API calls per day to this product are set up by default. If you want to change this limit, please go to the "Billing plans" tab in your Personal account to update standard settings. You can find more information on the FAQ.
- Select the desired type of data (Current and forecasts weather data, Weather data for timestamp, Daily aggregation, Weather overview) and make an API call according to relevant tech documentation section, remembering to add your key to each call.
Current and forecasts weather data
To get access to current weather, minute forecast for 1 hour, hourly forecast for 48 hours, daily forecast for 8 days and government weather alerts, please use this section of the documentation.
If you are interested in other functionality on One Call API 3.0, please check Product concept to follow the right section.
How to make an API call
API call
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&exclude={part}&appid={API key}
Parameters | ||
---|---|---|
lat |
required | Latitude, decimal (-90; 90). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API |
lon |
required | Longitude, decimal (-180; 180). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
exclude |
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:
|
units |
optional | Units of measurement. standard , metric and imperial
units are available. If you do not use the units parameter,
standard units will be applied by default. Learn more
|
lang |
optional | You can use the lang parameter to get the output in your language. Learn more |
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
If you you want to exclude some parts of the weather data from the API response please add
exclude
parameter to the API call like in the example below:
https://api.openweathermap.org/data/3.0/onecall?lat=33.44&lon=-94.04&exclude=hourly,daily&appid={API key}
If you do not need to exclude any of the weather data from the API response please use API call like in the example below:
https://api.openweathermap.org/data/3.0/onecall?lat=33.44&lon=-94.04&appid={API key}
Example of API response
Example of API response
Fields in API response
lat
Latitude of the location, decimal (−90; 90)lon
Longitude of the location, decimal (-180; 180)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, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the responsecurrent.sunset
Sunset time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the responsecurrent.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: Fahrenheitcurrent.clouds
Cloudiness, %current.uvi
Current UV index.current.visibility
Average visibility, metres. The maximum value of the visibility is 10 kmcurrent.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.rain
current.rain.1h
(where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
current.snow
current.snow.1h
(where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
-
current.weather
current.weather.id
Weather condition idcurrent.weather.main
Group of weather parameters (Rain, Snow 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 icons
minutely
Minute forecast weather data API responseminutely.dt
Time of the forecasted data, unix, UTCminutely.precipitation
Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
hourly
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 10 kmhourly.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 usedhourly.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.rain
hourly.rain.1h
(where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
hourly.snow
hourly.snow.1h
(where available) Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
-
hourly.weather
hourly.weather.id
Weather condition idhourly.weather.main
Group of weather parameters (Rain, Snow 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 icons
-
daily
Daily forecast weather data API responsedaily.dt
Time of the forecasted data, Unix, UTCdaily.sunrise
Sunrise time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the responsedaily.sunset
Sunset time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the responsedaily.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
and1
are 'new moon',0.25
is 'first quarter moon',0.5
is 'full moon' and0.75
is 'last quarter moon'. The periods in between are called 'waxing crescent', 'waxing gibbous', 'waning gibbous', and 'waning crescent', respectively. Moon phase calculation algorithm: if the moon phase values between the start of the day and the end of the day have a round value (0, 0.25, 0.5, 0.75, 1.0), then this round value is taken, otherwise the average of moon phases for the start of the day and the end of the day is takensummary
Human-readable description of the weather conditions for the daydaily.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) Precipitation volume, mm. Please note that only mm as units of measurement are available for this parameterdaily.snow
(where available) Snow volume, mm. Please note that only mm as units of measurement are available for this parameterdaily.weather
daily.weather.id
Weather condition iddaily.weather.main
Group of weather parameters (Rain, Snow 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 icons
-
alerts
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 weather
Please note that some agencies provide the alert’s description only in a local language.
Weather data for timestamp
To learn about how get access to weather data for any timestamp from 1st January 1979 till 4 days ahead forecast, please use this section of the documentation.
If you are interested in other functionality on One Call API 3.0, please check Product concept to follow the right section.
How to make an API call
API call
https://api.openweathermap.org/data/3.0/onecall/timemachine?lat={lat}&lon={lon}&dt={time}&appid={API key}
Parameters | ||
---|---|---|
lat |
required | Latitude, decimal (-90; 90). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API |
lon |
required | Longitude, decimal (-180; 180). If you need the geocoder to automatic convert city names and zip-codes to geo coordinates and the other way around, please use our Geocoding API |
dt |
required | Timestamp (Unix time, UTC time zone), e.g. dt=1586468027. Data is available from January 1st, 1979 till 4 days ahead |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
units |
optional | Units of measurement. standard , metric and imperial
units are available. If you do not use the units parameter,
standard units will be applied by default. Learn more
|
lang |
optional | You can use the lang parameter to get the output in your language. Learn more |
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
https://api.openweathermap.org/data/3.0/onecall/timemachine?lat=39.099724&lon=-94.578331&dt=1643803200&appid={API key}
Example of API response
Example of API response
{
"lat": 52.2297,
"lon": 21.0122,
"timezone": "Europe/Warsaw",
"timezone_offset": 3600,
"data": [
{
"dt": 1645888976,
"sunrise": 1645853361,
"sunset": 1645891727,
"temp": 279.13,
"feels_like": 276.44,
"pressure": 1029,
"humidity": 64,
"dew_point": 272.88,
"uvi": 0.06,
"clouds": 0,
"visibility": 10000,
"wind_speed": 3.6,
"wind_deg": 340,
"weather": [
{
"id": 800,
"main": "Clear",
"description": "clear sky",
"icon": "01d"
}
]
}
]
}
Fields in API response
lat
Latitude of the location, decimal (−90; 90)lon
Longitude of the location, decimal (-180; 180)timezone
Timezone name for the requested locationtimezone_offset
Shift in seconds from UTCdata
data.dt
Requested time, Unix, UTCdata.sunrise
Sunrise time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the responsedata.sunset
Sunset time, Unix, UTC. For polar areas in midnight sun and polar night periods this parameter is not returned in the responsedata.temp
Temperature. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units useddata.feels_like
Temperature. This accounts for the human perception of weather. Units – default: kelvin, metric: Celsius, imperial: Fahrenheit.data.pressure
Atmospheric pressure on the sea level, hPadata.humidity
Humidity, %data.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.data.clouds
Cloudiness, %data.uvi
UV index. Please pay attention that historical UV index data available only for 5 days back. If you would like to get historical UVI index data starting from 20th September 2020 please contact usdata.visibility
Average visibility, metres. The maximum value of the visibility is 10 kmdata.wind_speed
Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddata.wind_gust
(where available) Wind gust. Wind speed. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddata.wind_deg
Wind direction, degrees (meteorological)data.weather
data.weather.id
Weather condition iddata.weather.main
Group of weather parameters (Rain, Snow etc.)data.weather.description
Weather condition within the group (full list of weather conditions). Get the output in your languagedata.weather.icon
Weather icon id. How to get icons
data.rain
(where available)1h
Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
data.snow
(where available)1h
Precipitation, mm/h. Please note that only mm/h as units of measurement are available for this parameter
Daily Aggregation
To learn about how get access to aggregated weather data for a particular date from 2nd January 1979 till long-term forecast for 1,5 years ahead, please use this section of the documentation.
If you are interested in other functionality on One Call API 3.0, please check Product concept to follow the right section.
How to make an API call
API call
https://api.openweathermap.org/data/3.0/onecall/day_summary?lat={lat}&lon={lon}&date={date}&appid={API key}
Parameters | ||
---|---|---|
lat |
required | Latitude, decimal (-90; 90) |
lon |
required | Longitude, decimal (-180; 180) |
date |
required | Date in the `YYYY-MM-DD` format for which data is requested. Date is available for 45+ years archive (starting from 1979-01-02) up to the 1,5 years ahead forecast to the current date |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
units |
optional | Units of measurement. standard , metric and imperial
units are available. If you do not use the units parameter,
standard units will be applied by default. Learn more
|
lang |
optional | You can use the lang parameter to get the output in your language. Learn more |
tz
parameter in the ±XX:XX format to API call.
API call
https://api.openweathermap.org/data/3.0/onecall/day_summary?lat={lat}&lon={lon}&date={date}&tz={tz}&appid={API key}
Example of API call
https://api.openweathermap.org/data/3.0/onecall/day_summary?lat=60.45&lon=-38.67&date=2023-03-30&tz=+03:00&appid={API key}
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
https://api.openweathermap.org/data/3.0/onecall/day_summary?lat=39.099724&lon=-94.578331&date=2020-03-04&appid={API key}
Example of API response
Example of API response
{
"lat":33,
"lon":35,
"tz":"+02:00",
"date":"2020-03-04",
"units":"standard",
"cloud_cover":{
"afternoon":0
},
"humidity":{
"afternoon":33
},
"precipitation":{
"total":0
},
"temperature":{
"min":286.48,
"max":299.24,
"afternoon":296.15,
"night":289.56,
"evening":295.93,
"morning":287.59
},
"pressure":{
"afternoon":1015
},
"wind":{
"max":{
"speed":8.7,
"direction":120
}
}
}
Fields in API response
lat
Latitude of the location, decimal (−90; 90)lon
Longitude of the location, decimal (-180; 180)tz
Timezone in the ±XX:XX formatdate
Date specified in the API request in the `YYYY-MM-DD` format (from 1979-01-02 up to the 1,5 years ahead forecast)units
Units of measurement specified in the request. Learn morecloud_cover
Cloud related informationafternoon
Cloud cover at 12:00 for the date specified in the request, %
humidity
Humidity related informationafternoon
Relative humidity at 12:00 for the date specified in the request, %
precipitation
Precipitation related informationtotal
Total amount of liquid water equivalent of precipitation for the date specified in the request, mm
pressure
Atmospheric pressure related informationafternoon
Atmospheric pressure at 12:00 for the date specified in the request, hPa
temperature
Temperature related informationmin
Minimum temperature for the date specified in the request. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedmax
Maximum temperature for the date specified in the request. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedafternoon
Temperature at 12:00 for the date specified in the request. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usednight
Temperature at 00:00 for the date specified in the request. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedevening
Temperature at 18:00 for the date specified in the request. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units usedmorning
Temperature at 06:00 for the date specified in the request. Units - default: kelvin, metric: Celsius, imperial: Fahrenheit. How to change units used
wind
Wind speed related informationmax
Maximum wind speed related informationspeed
Maximum wind speed for the date specified in the request. Units – default: metre/sec, metric: metre/sec, imperial: miles/hour. How to change units useddirection
Wind cardinal direction relevant to the maximum wind speed, degrees (meteorological)
Weather overview
This section describes how to get weather overview with a human-readable weather summary for today and tomorrow's forecast, utilizing OpenWeather AI technologies.
If you are interested in other functionality on One Call API 3.0, please check Product concept to follow the right section.
How to make an API call
API call
https://api.openweathermap.org/data/3.0/onecall/overview?lat={lat}&lon={lon}&appid={API key}
Parameters | ||
---|---|---|
lat |
required | Latitude, decimal (-90; 90) |
lon |
required | Longitude, decimal (-180; 180) |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
date |
optional | The date the user wants to get a weather summary in the YYYY-MM-DD format. Data is available for today and tomorrow. If not specified, the current date will be used by default. Please note that the date is determined by the timezone relevant to the coordinates specified in the API request |
units |
optional | Units of measurement. Standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default. Learn more |
Example of API call
https://api.openweathermap.org/data/3.0/onecall/overview?lon=-11.8092&lat=51.509865&appid={API key}
Example of API response
{
"lat": 51.509865,
"lon": -0.118092,
"tz": "+01:00",
"date": "2024-05-13",
"units": "metric",
"weather_overview": "The current weather is overcast with a
temperature of 16°C and a feels-like temperature of 16°C.
The wind speed is 4 meter/sec with gusts up to 6 meter/sec
coming from the west-southwest direction.
The air pressure is at 1007 hPa with a humidity level of 79%.
The dew point is at 12°C and the visibility is 10000 meters.
The UV index is at 4, indicating moderate risk from the
sun's UV rays.
The sky is covered with overcast clouds, and there is
no precipitation expected at the moment.
Overall, it is a moderately cool and cloudy day
with light to moderate winds from the west-southwest."
}
Fields in API response
lat
Latitude of the location, decimal (−90; 90)lon
Longitude of the location, decimal (-180; 180)tz
Timezone in the ±XX:XX formatdate
Date for which summary is generated in the format YYYY-MM-DDunits
Units of measurement specified in the requestweather_overview
AI generated weather overview for the requested date
Other features
List of weather condition codes
List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere etc.)
Units of measurement
standard
, metric
and imperial
units are available.
API call
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&units={units}
Parameters | ||
---|---|---|
units |
optional | Units of measurement. standard , metric and imperial
units are available. If you do not use the units parameter,
standard units will be applied by default.
|
Wind speed is available in miles/hour and meter/sec.
- For temperature in Fahrenheit and wind speed in miles/hour, use
units=imperial
- For temperature in Celsius and wind speed in meter/sec, use
units=metric
- Temperature in Kelvin and wind speed in meter/sec is used by default, so there is no need to use the units parameter in the API call if you want this
Examples of API calls
Standard (default)
api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335
Metric
api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335&units=metric
Imperial
api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335&units=imperial
Multilingual support
You can use lang
parameter to get the output in your language.
The contents of the description
field will be translated.
API call
https://api.openweathermap.org/data/3.0/onecall?lat={lat}&lon={lon}&lang={lang}
Parameters | ||
---|---|---|
lang |
optional | You can use the lang parameter to get the output in your language. |
Example of API call
Before making an API call, please note, that One Call 3.0 is included in the "One Call by Call" subscription only. Learn more
https://api.openweathermap.org/data/3.0/onecall?lat=30.489772&lon=-99.771335&lang=zh_cn
We support the following languages. To select one, you can use the corresponding language code:
sq
Albanianaf
Afrikaansar
Arabicaz
Azerbaijanieu
Basquebe
Belarusianbg
Bulgarianca
Catalanzh_cn
Chinese Simplifiedzh_tw
Chinese Traditionalhr
Croatiancz
Czechda
Danishnl
Dutchen
Englishfi
Finnishfr
Frenchgl
Galiciande
Germanel
Greekhe
Hebrewhi
Hindihu
Hungarianis
Icelandicid
Indonesianit
Italianja
Japanesekr
Koreanku
Kurmanji (Kurdish)la
Latvianlt
Lithuanianmk
Macedonianno
Norwegianfa
Persian (Farsi)pl
Polishpt
Portuguesept_br
Português Brasilro
Romanianru
Russiansr
Serbiansk
Slovaksl
Sloveniansp, es
Spanishsv, se
Swedishth
Thaitr
Turkishua, uk
Ukrainianvi
Vietnamesezu
Zulu
List of national weather alerts sources
Country | Agency |
---|---|
Albania | Institute of GeoSciences, Energy, Water and Environment of Albania |
Algeria | National Meteorological Office |
Argentina | National Weather Service of Argentina |
Australia | Australian Bureau of Meteorology |
Austria |
|
Bahrain | Bahrain Meteorological Directorate |
Barbados | Barbados Meteorological Service |
Belarus | State institution "Republican center for hydrometeorology, control of radioactive contamination and environmental monitoring" (Belhydromet) |
Belgium | Royal Meteorological Institute |
Belize | National Meteorological Service of Belize |
Benin | National Meteorological Agency (METEO-BENIN) |
Bosnia and Herzegovina |
|
Botswana | Botswana Meteorological Services |
Brazil | National Meteorological Institute - INMET |
Bulgaria | National Institute of Meteorology and Hydrology - Plovdiv branch |
Cameroon | Cameroon National Meteorological Service |
Canada |
|
Chile | Meteorological Directorate of Chile |
Congo | National Civil Aviation Agency (ANAC Congo) |
Costa Rica | National Meteorological Institute of Costa Rica |
Croatia | State Hydrometeorological Institute (DHMZ) |
Curacao and Sint Maarten | Meteorological Department Curacao |
Cyprus | Republic of Cyprus - Department of Meteorology |
Czech Republic | Czech Hydrometeorological Institute |
Denmark | Danish Meteorological Institute |
Ecuador | Ecuadoran Institute for Meteorology and Hydrology (INAMHI) |
Egypt | Egyptian Meteorological Authority |
Estonia | Estonian Environment Agency |
Eswatini | Eswatini Meteorological Service |
Finland | Finnish Meteorological Institute |
France | Meteo-France |
Gabon | General Directorate of Meteorology of Gabon |
Germany | German Meteorological Office |
Ghana | Ghana Meteorological Agency |
Greece | Hellenic National Meteorological Service |
Guinea | National Meteorological Agency of Guinea |
Guyana | Hydrometeorological Service of Guyana |
Hong Kong China | Hong Kong Observatory |
Hungary | Hungarian Meteorological Service |
Iceland | Icelandic Meteorological Office |
India | India Meteorological Department |
Indonesia |
|
Ireland | Met Eireann - Irish Meteorological Service |
Israel | Israel Meteorological Service |
Italy | Italian Air Force National Meteorological Service |
Ivory Coast | Airport, aeronautical and meteorological operating and development company (SODEXAM) |
Jamaica | Meteorological Service of Jamaica |
Jordan | Jordanian Meteorological Department |
Kazakhstan | National Hydrometeorological Service of the Republic of Kazakhstan (Kazhydromet) |
Kenya | Kenya Meteorological Department |
Kuwait | Kuwait Meteorological Department |
Latvia | Latvian Environment, Geology and Meteorology Center |
Lesotho | Lesotho Meteorological Services |
Libya | Libyan National Meteorological Center |
Lithuania | Lithuanian Hydrometeorological Service under the Ministry of Environment of the Republic of Lithuania (LHMS) |
Luxembourg | Luxembourg Airport Administration |
Macao China | Macao Meteorological and Geophysical Bureau |
Madagascar | METEO Madagascar |
Malawi | Malawi Department of Climate Change and Meteorological Services |
Maldives | Maldives Meteorological Service |
Mauritania | National Meteorological Office of Mauritania |
Mauritius | Mauritius Meteorological Services |
Mexico | CONAGUA - National Meteorological Service of Mexico |
Moldova | State Hydrometeorological Service of Moldova |
Mongolia | National Agency Meteorology and the Environmental Monitoring of Mongolia |
Mozambique | National Institute of Meteorology of Mozambique |
Myanmar | Myanmar Department of Meteorology and Hydrology |
Netherlands | Royal Netherlands Meteorological Institute (KNMI) |
New Zealand |
|
New Zealand | New Zealand Emergency Mobile Alert |
Niger | National Meteorological Directorate of Niger |
Nigeria | Nigerian Meteorological Agency (NiMet) |
North Macedonia | National Hydrometeorological Service - Republic of Macedonia |
Norway |
|
Paraguay | Directorate of Meteorology and Hydrology |
Philippines | Philippine Atmospheric Geophysical and Astronomical Services Administration |
Poland | Institute of Meteorology and Water Management (IMGW-PIB) |
Portugal | Portuguese Institute of Sea and Atmosphere, I.P. |
Qatar | Qatar Meteorology Department |
Republic of Korea | Korea Meteorological Administration, Weather Information |
Romania | National Meteorological Administration |
Russia-EN | Hydrometcenter of Russia |
Russia-RU | Russian Federal Service for Hydrometeorology and Environmental Monitoring |
Saudi Arabia | National Center for Meteorology - Kingdom of Saudi Arabia |
Serbia | Republic Hydrometeorological Service of Serbia |
Seychelles | Seychelles Meteorological Authority |
Singapore | Meteorological Service Singapore |
Slovakia | Slovak Hydrometeorological Institute |
Slovenia | National Meteorological Service of Slovenia |
Solomon Islands | Solomon Islands Meteorological Services |
South Africa | South African Weather Service (SAWS) |
Spain | State Meteorological Agency (AEMET) |
Sudan | Sudan Meteorological Authority |
Sweden | Swedish Meteorological and Hydrological Institute |
Switzerland | MeteoSwiss |
Tanzania | Tanzania Meteorological Authority |
Thailand | Thai Meteorological Department |
Timor-Leste | National Directorate of Meteorology and Geophysics of Timor-Leste |
Trinidad and Tobago | Trinidad and Tobago Meteorological Service |
Ukraine | Ukrainian Hydrometeorological Center |
United Kingdom of Great Britain and Northern Ireland | UK Met Office |
Uruguay | Uruguayan Institute of Meteorology |
United States |
|
USA | National Oceanic and Atmospheric Administration |
Yemen | Yemeni Civil Aviation and Meteorology Authority (CAMA) |
Zambia | Meteorological Department Zambia |
Zimbabwe | Meteorological Services Department |
Please note that some agencies from the list may cease to provide us the weather alert
information.
In case you don’t receive alerts from any agency, please contact us.
We constantly work on our product’s improvement and keep expanding the list of partner
agencies.
Call back function for JavaScript code
To use JavaScript code you can transfer callback
functionName to JSONP callback.
API call example
api.openweathermap.org/data/3.0/onecall?lat=38.8&lon=12.09&callback=test
test({
"lat": 40.12,
"lon": -96.66,
"timezone": "America/Chicago",
"timezone_offset": -18000,
"current": {
"dt": 1595243443,
"sunrise": 1595243663,
"sunset": 1595296278,
"temp": 293.28,
"feels_like": 293.82,
"pressure": 1016,
"humidity": 100,
"dew_point": 293.28,
"uvi": 10.64,
"clouds": 90,
"visibility": 10000,
"wind_speed": 4.6,
"wind_deg": 310,
"weather": [
{
"id": 501,
"main": "Rain",
"description": "moderate rain",
"icon": "10n"
},
{
"id": 201,
"main": "Thunderstorm",
"description": "thunderstorm with rain",
"icon": "11n"
}
],
"rain": {
"1h": 2.93
}
},
"minutely": [
{
"dt": 1595243460,
"precipitation": 2.928
},
...
},
"hourly": [
{
"dt": 1595242800,
"temp": 293.28,
"feels_like": 293.82,
"pressure": 1016,
"humidity": 100,
"dew_point": 293.28,
"clouds": 90,
"visibility": 10000,
"wind_speed": 4.6,
"wind_deg": 123,
"weather": [
{
"id": 501,
"main": "Rain",
"description": "moderate rain",
"icon": "10n"
}
],
"pop": 0.99,
"rain": {
"1h": 2.46
}
},
...
}
"daily": [
{
"dt": 1595268000,
"sunrise": 1595243663,
"sunset": 1595296278,
"temp": {
"day": 298.82,
"min": 293.25,
"max": 301.9,
"night": 293.25,
"eve": 299.72,
"morn": 293.48
},
"feels_like": {
"day": 300.06,
"night": 292.46,
"eve": 300.87,
"morn": 293.75
},
"pressure": 1014,
"humidity": 82,
"dew_point": 295.52,
"wind_speed": 5.22,
"wind_deg": 146,
"weather": [
{
"id": 502,
"main": "Rain",
"description": "heavy intensity rain",
"icon": "10d"
}
],
"clouds": 97,
"pop": 1,
"rain": 12.57,
"uvi": 10.64
},
...
},
"alerts": [
{
"sender_name": "NWS Tulsa (Eastern Oklahoma)",
"event": "Heat Advisory",
"start": 1597341600,
"end": 1597366800,
"description": "...HEAT ADVISORY REMAINS IN EFFECT FROM 1 PM THIS AFTERNOON TO\n8 PM CDT THIS EVENING...\n* WHAT...Heat index values of 105 to 109 degrees expected.\n* WHERE...Creek, Okfuskee, Okmulgee, McIntosh, Pittsburg,\nLatimer, Pushmataha, and Choctaw Counties.\n* WHEN...From 1 PM to 8 PM CDT Thursday.\n* IMPACTS...The combination of hot temperatures and high\nhumidity will combine to create a dangerous situation in which\nheat illnesses are possible."
},
...
]
})
API errors
Structure of API errors
In case of incorrected API call you will receive API error response. Error response payload returned for all types of errors with the structure below.
Example of error response
Example of error response
{
"cod":400,
"message":"Invalid date format",
"parameters": [
"date"
]
}
Fields in error response
cod
Code of errormessage
Description of errorparameters
(optional) List of request parameters names that are related to this particular error
Errors list
Please find more detailed information about some popular errors below.
API calls return an error 400
Error 400 - Bad Request. You can get 400 error if either some mandatory parameters in the request are missing or some of request parameters have incorrect format or values out of allowed range. List of all parameters names that are missing or incorrect will be returned in `parameters`attribute of the `ErrorResponse` object.
API calls return an error 401
Error 401 - Unauthorized. You can get 401 error if API token did not providen in the request or in case API token provided in the request does not grant access to this API. You must add API token with granted access to the product to the request before returning it.
API calls return an error 404
Error 404 - Not Found. You can get 404 error if data with requested parameters
(lat
, lon
, date
etc) does not exist in service
database. You must not retry the same request.
API calls return an error 429
Error 429 - Too Many Requests. You can get 429 error if key quota of requests for provided API to this API was exceeded. You may retry request after some time or after extending your key quota.
API calls return errors '5xx'
Errors 5xx - Unexpected Error. You can get '5xx' error in case of other internal errors. Error Response code will be `5xx`. Please contact us and enclose an example of your API request that receives this error into your email to let us analyze it and find a solution for you promptly. You may retry the request which led to this error.