When we make backward-incompatible changes to the API, we release new, dated versions.
Review the Migration Guide for more details on required changes for an upgrade.
DATAEvapotranspiration – We've added
evapotranspirationdata field according to Penman–Monteith FAO56 calculation. This is a big step for our API towards supporting our agriculture customers.
DATAHistorical – We have added four Growing Degree Days data fields to our Historical API with different temperature base and temperature cap values:
DATACore – We have added moon rise and moon set times to our Timeline API. The fields
moonsetTimeare available using the
timezoneparameter - We added The ability to set the API response timestamps according to the user location using a new auto option in the timezone API parameter. see how it works
DATACore – We have improved our precipitation models significantly and can now offer better data for
DATACore – We have added four Growing Degree Days data fields to our Timeline API with different temperature base and temperature cap values:
APIHistorical API expansion to 22 years! We now provide historical data from the year 2000 This will help conduct climatological research, explore how the weather is changing around the globe, and make predictions for the coming years.
DATAFlood – High Resolution (1-km) CONUS Flood Index.
APINew time Formats support for our APIs. We now offer support for string datetime formats in the startTime and endTime API parameters:
Xm/h/d" where X is a decimal number. For example, nowPlus3h will be the time 3 hours from
Xm/h/d" where X is a decimal number. For example, nowMinus15m will be the time 15
DATANew Maritime data fields:
DATANew Historical API
cloudCoverdata field – We now have historical data for cloud cover, globally .
APINew Historical API percentile aggregation. You can request any historical field with the percentile suffix
P95. The percentile aggregation will aggregate the data over the area (polygon and polyline) and time .
DATAWildfire Smoke Index – We now provide wildfire smoke index on land, globally. The wildfire smoke index conveys the risk that an area may be exposed to elevated particulate matter concentrations (PM2.5) from nearby fires. The new data field returns values between 0 to 5, where 0 indicates there's no risk and 5 indicates the likelihood of extreme smoke concentrations. The new data field is also supported by our Map API and returns tiles over areas that have wildfire smoke.
APIAlerts API - All Clear Duration - We added the ability to define an “all clear duration” which will determine the amount of time for which conditions must be forecasted as unmet for the “all clear” alert to be sent.
DATAHail – We now support real-time and forecast Hail over the US and Canada. The new data field returns
0when there is no hail and
1when hail has been detected. The new data field is also supported by our Map API and returns tiles over areas that have hail.
DATAAviation – We added a new data layer section for aviation. We now provide METAR, TAF, ASOS, and other airport weather observations directly through our Timeline API.
SLOStatus Page – We launched a new status page to publish outages and notify our customers when our services are unavailable.
APITimeline API - We've extended our timeline data from -48 hours to -7 dyas. You can now have -7 days in the past and 14 days forecast with a single API call.
DATACore – We have expanded our precipitation models to include India, Panama, and Mexico.
APIBulk Location Tags - We've added the option to add or remove 100 tags for multiple locations in one bulk request.
APIBulk Insights Tags - We've added the option to add or remove 100 tags for multiple insights in one bulk request.
DATACore – Introducing three new data fields:
sleetAccumulation. The new fields can be used by our Create an Insight API to monitor specific precipitation accumulation types over a point location, polygon, and polyline.
Documentation- Documentation portal functional improvements including dynamically generate code in real time, interactive API logs experience, API calls history, and support for more code languages.
APIOverview ] – New API Product - With the new synchronous historical API you can now query for historical data, going back to January 1st, 2015.
DATACore – Introducing four new data fields:
sleetIntensity. The new fields can be used by our Create an Insight API to monitor specific precipitation types over a point location, polygon, and polyline.
APIMap API - We introduce a significant upgrade to our visualization abilities.
APIList Notifications ] - The Notifications API allows getting a list of all sent notifications. We provide the flexibility to filter notifications based on the Alert ID, Notification Type, Notification Recipient, Notification Status, and Location.
DATA Weather Codes - New weather codes conditions, mixed weather conditions, and new weather codes icons. We've also added
weatherCodeDay to visualize the weather during day time, and
weatherCodeNight for night time.
APICreate an Insight - We've added the option to add tags to an insight.
APICreate a Location - We've added the option to add tags to a location.
DATAStream Flow - the volume of water moving down a stream or river per unit of time.
DATARain Accumulation - The rain accumulation data is now available through our Timeline API, indicating the amount of liquid rain that has occurred or will have occurred within a given timeframe.
DATAFlood Index - The Flood Index data layer is now available and enables our customers to forecast floods and gain insights into their severity.
DATALightning Flash Rate Density - The Lightning Flash Rate Density data layer is now available and measures the total cloud-cloud and cloud-ground instantaneous lightning flashes per unit time per unit area.
API14 Days Hourly - Users can now get up to days of weather forecast with hourly resolution by querying the /timeline endpoint with the 1h timestep.
API48 Hours Historical weather - Users can now get access to up to 48 hours of historical weather data.
APIInsights on Severe Weather Events - Turn government agencies' weather warnings on upcoming Severe Weather Events into specific insights and impacts over your key locations
DATAUV index - The UV index data layer is now available, indicating the strength of sunburn-causing UV radiation at any particular place and time.
APIIn a major update, Insights and Alerts are now available for both Polygons and Polylines, instead of just for point locations as was previously available. Now users can get weather intelligence and forecasts in a more flexible manner across all location types.
DATAPrecipitation – Added snow accumulation to this data layer to allow you to better prepare for winter weather
DATAPrecipitation – Added ice accumulation to this data layer to allow you to better prepare for winter weather
DASHBOARDHome Page – Welcome to your new home, where you will find step-by-step solution guides, get familiar with our interfaces and browse data coverage
APISevere Weather Alerts – Get government agencies' weather warnings pushed to your webhook endpoint as soon as they are published
DATAMaritime, Solar and Land – Introducing three new data layers, adding >20 new data points covering waves, solar irradiance and soil
API"best" Timestep in Timeline – Get the highest temporal resolution available by querying the /timeline endpoint with this new timestep enum
DASHBOARDAccount Settings Page – Take control of your account by managing your own plans, billing quotas, etc.
DASHBOARDActivity Page – Visualize all call going out to the Tomorrow.io API, broken down by status, method and endpoint group
APISevere Weather Events – Increase your assets safety and business efficiency by pulling future government agencies' weather warnings of critical sites
APINotification Descriptive Attributes – Extending the notification objects with "title" and "description", thereby you have all communication content within the webhook payload
This is the base version of the API that existed before the changelog was introduced.