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.
2023Q3:
August:
- Lean Endpoints Daily Timestep is now 6AM-6AM to align with the daily timestep with the rest of the system.
- Events timeline let's you get the timeframes in which weather conditions are available for a location
v4/events-timeline
July
- New probabilistic Forecast Is now available for many of the API Data Layers!
- New Token System is added to Historical Endpoint more details on https://docs.tomorrow.io/reference/rate-limiting
- New error of insufficient tokens is added: 402001
2023Q2:
June:
May:
- new DPL:
2023Q1
February:
New Lean endpoints:
2022Q4
November
-
DATA
Evapotranspiration – We've addedevapotranspiration
data field according to Penman–Monteith FAO56 calculation. This is a big step for our API towards supporting our agriculture customers. 🍃 -
DATA
Historical – We have added four Growing Degree Days data fields to our Historical API with different temperature base and temperature cap values:gdd10To30
,gdd10To31
,gdd08To30
, andgdd03To25
. -
DATA
Core – We have added moon rise and moon set times to our Timeline API. The fieldsmoonriseTime
andmoonsetTime
are available using the1d
time step. -
API
Newtimezone
parameter - 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
October
DATA
Core – We have improved our precipitation models significantly and can now offer better data forprecipitationProbability
,precipitationIntensity
,rainIntensity
,freezingRainIntensity
,snowIntensity
,sleetIntensity
,rainAccumulation
,snowAccumulation
,snowAccumulationLwe
,sleetAccumulation
,sleetAccumulationLwe
,iceAccumulation
,andiceAccumulationLwe
.
2022Q3
September
DATA
Core – We have added four Growing Degree Days data fields to our Timeline API with different temperature base and temperature cap values:gdd10To30
,gdd10To31
,gdd08To30
, andgdd03To25
.
August
-
API
Historical API expansion to 22 years! We now provide historical data from the year 2000 :clock113: This will help conduct climatological research, explore how the weather is changing around the globe, and make predictions for the coming years. -
DATA
Flood – High Resolution (1-km) CONUS Flood Index.
July
-
API
New time Formats support for our APIs. We now offer support for string datetime formats in the startTime and endTime API parameters:
1. "now"
2. "nowPlusX
m/h/d" where X is a decimal number. For example, nowPlus3h will be the time 3 hours from
now.
3. "nowMinusX
m/h/d" where X is a decimal number. For example, nowMinus15m will be the time 15
minutes earlier. -
DATA
New Maritime data fields:seaSurfaceTemperature
,seaCurrentSpeed
,seaCurrentDirection
, andtides
🌊.
2022Q2
June
-
DATA
New Historical APIcloudCover
data field – We now have historical data for cloud cover, globally ☁️ . -
API
New Historical API percentile aggregation. You can request any historical field with the percentile suffixP5
,P50
,P95
. The percentile aggregation will aggregate the data over the area (polygon and polyline) and time 📈 . -
DATA
Wildfire 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.
May
API
Alerts 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.DATA
Hail – We now support real-time and forecast Hail ✨ over the US and Canada. The new data field returns0
when there is no hail and1
when hail has been detected. The new data field is also supported by our Map API and returns tiles over areas that have hail.
April
DATA
Aviation – 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.SLO
Status Page – We launched a new status page to publish outages and notify our customers when our services are unavailable.
2022Q1
March
API
Timeline 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.DATA
Core – We have expanded our precipitation models to include India, Panama, and Mexico.
February
API
Bulk Location Tags - We've added the option to add or remove 100 tags for multiple locations in one bulk request.API
Bulk Insights Tags - We've added the option to add or remove 100 tags for multiple insights in one bulk request.DATA
Core – Introducing three new data fields:rainAccumulation
,iceAccumulation
,snowAccumulation
, andsleetAccumulation
. 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.
January
API
Overview ] – New API Product 🚀 - With the new synchronous historical API you can now query for historical data, going back to January 1st, 2015.DATA
Core – Introducing four new data fields:rainIntensity
,freezingRainIntensity
,snowIntensity
, andsleetIntensity
. The new fields can be used by our Create an Insight API to monitor specific precipitation types over a point location, polygon, and polyline.
2021Q4
December
API
Map API - We introduce a significant upgrade to our visualization abilities.API
List 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.
November
*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.
API
Create an Insight - We've added the option to add tags to an insight.
October
API
Create a Location - We've added the option to add tags to a location.DATA
Stream Flow - the volume of water moving down a stream or river per unit of time.
2021Q3
September
DATA
Rain 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.
August
DATA
Flood Index - The Flood Index data layer is now available and enables our customers to forecast floods and gain insights into their severity.
July
DATA
Lightning 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.
2021Q2
June
API
14 Days Hourly - Users can now get up to days of weather forecast with hourly resolution by querying the /timeline endpoint with the 1h timestep.API
48 Hours Historical weather - Users can now get access to up to 48 hours of historical weather data.API
Insights on Severe Weather Events - Turn government agencies' weather warnings on upcoming Severe Weather Events into specific insights and impacts over your key locationsDATA
UV index - The UV index data layer is now available, indicating the strength of sunburn-causing UV radiation at any particular place and time.
May
API
In 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.
April
DATA
Precipitation – Added snow accumulation to this data layer to allow you to better prepare for winter weatherDATA
Precipitation – Added ice accumulation to this data layer to allow you to better prepare for winter weather
2021Q1
March
DASHBOARD
Home Page – Welcome to your new home, where you will find step-by-step solution guides, get familiar with our interfaces and browse data coverageAPI
Severe Weather Alerts – Get government agencies' weather warnings pushed to your webhook endpoint as soon as they are published
February
DATA
Maritime, Solar and Land – Introducing three new data layers, adding >20 new data points covering waves, solar irradiance and soilAPI
"best" Timestep in Timeline – Get the highest temporal resolution available by querying the /timeline endpoint with this new timestep enum
January
DASHBOARD
Account Settings Page – Take control of your account by managing your own plans, billing quotas, etc.DASHBOARD
Activity Page – Visualize all call going out to the Tomorrow.io API, broken down by status, method and endpoint groupAPI
Severe Weather Events – Increase your assets safety and business efficiency by pulling future government agencies' weather warnings of critical sitesAPI
Notification Descriptive Attributes – Extending the notification objects with "title" and "description", thereby you have all communication content within the webhook payload
2020Q4
This is the base version of the API that existed before the changelog was introduced.