Our database receives data from over 20 different data sources. These data sources feed into our system with varying lag times ranging from 15 minutes (MADIS station data) to 7-10 days (Reanalysis data). This can result in historical data being corrected with higher quality observations as the lagging (higher quality) datasets feed in.

You may use the "revision_status" field to determine whether or not you will need to retrieve updated data at a later date. The field will return "interim" for data still awaiting updates, and "final" for data that has been finalized. Most historical endpoints reach their final state within 10 days.

As a general practice we recommend querying again for past data to obtain these revisions using the "revision_status" field to determine whether or not to replace data in any locally hosted database.




{
   "city_id":"4161685",
   "city_name":"Lawtey",
   "country_code":"US",
   "data":[
      {
         "clouds":50,
         "datetime":"2022-11-12",
         "dewpt":65.8,
         ...,
         "revision_status":"final",
         ...
      }
   ],
   "lat":30.149230998969,
   "lon":-82.01068631381,
   "sources":[
      "722067-63823",
      "US1FLCY0040",
      "US1FLCY0012",
      "US1FLCY0009",
      "imerg",
      "merra2",
      "era5",
      "modis"
   ],
   "state_code":"FL",
   "station_id":"722067-63823",
   "timezone":"America/New_York"
}
When the "revision_status" field is set to "final" the data is no longer subject to possible revisions. 



{
   "city_id":"4161685",
   "city_name":"Lawtey",
   "country_code":"US",
   "data":[
      {
         "clouds":67,
         "datetime":"2022-11-21",
         ...,
         "revision_status":"interim",
         ...
      }
   ],
   "lat":30.149230998969,
   "lon":-82.01068631381,
   "sources":[
      "722067-63823",
      "US1FLCY0040",
      "US1FLCY0012",
      "US1FLCY0009",
      "imerg",
      "merra2",
      "era5",
      "modis"
   ],
   "state_code":"FL",
   "station_id":"722067-63823",
   "timezone":"America/New_York"
}
When the "revision_status" field is set to "interim" the data may receive updates in the coming days.