ReferenceRecipesFAQsHelp CenterBlogAPI Status
Reference
Get Your Free API Key

Changelog

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

2023Q2:

June:

May:

  • new DPL:

Low level winds

2023Q1

February:

New Lean endpoints:

/v4/weather/forecast

/v4/weather/realtime

/v4/weather/history/recent

2022Q4

November

  • DATA Evapotranspiration – We've added evapotranspiration 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, and gdd03To25.

  • DATA Core – We have added moon rise and moon set times to our Timeline API. The fields moonriseTime and moonsetTime are available using the 1d time step.

  • API New timezone 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 for precipitationProbability,precipitationIntensity,rainIntensity,freezingRainIntensity,snowIntensity,sleetIntensity,rainAccumulation,snowAccumulation,snowAccumulationLwe,sleetAccumulation
    ,sleetAccumulationLwe,iceAccumulation,and iceAccumulationLwe.

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, and gdd03To25.

August

  • APIHistorical 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. "nowPlusXm/h/d" where X is a decimal number. For example, nowPlus3h will be the time 3 hours from
    now.
    3. "nowMinusXm/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, and tides 🌊.

2022Q2

June

  • DATA New Historical API cloudCover 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 suffix P5, 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 returns 0 when there is no hail and 1 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, and 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.

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, and 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.

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.

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 locations
  • DATA 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 weather
  • DATA 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 coverage
  • API Severe Weather Alerts – Get government agencies' weather warnings pushed to your webhook endpoint as soon as they are published

February

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 group
  • API Severe Weather Events – Increase your assets safety and business efficiency by pulling future government agencies' weather warnings of critical sites
  • API 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.