Summer 2024 Impacts to WaterServices
WaterServices databases are receiving a major version update to meet security and dependency requirements.
WaterServices APIs are being decommissioned in 2027!
We have released modernized Water Data APIs which will supersede the WaterServices family of APIs. Users will need to migrate their applications to use these new services in order to retain uninterrupted access to USGS water data going forward. Read this blog for more information.
WaterServices databases are receiving a major version update to meet security and dependency requirements. Beginning August 5, 2024, mandatory database updates will begin, and the following WaterService format return types will be permanently discontinued:
- Instantaneous Values (IV) WaterML2
- Groundwater (GW) Levels WaterML2
- Groundwater (GW) Levels RDB
No disruption in the availability of USGS hydrologic data is expected to occur as a result of the update. After August 5, 2024, web service requests to the impacted endpoints will return 503 “service unavailable” errors.
The JSON return type will continue to function as intended for both IV and GW Levels endpoints. Users should transition from WaterML2 and RDB return types to JSON to continue receiving data. The test tools on the WaterServices home page can be used to build and test replacement queries. Moving forward, the JSON return type will be the recommended data format to use when requesting data from WaterServices. All available formats for all data available using WaterServices are described at https://waterservices.usgs.gov .
We understand this loss of these formats may require changes to downstream data systems. Please reach out to GS-W_Waterdata_Support@usgs.gov with questions or support requests.
Categories:
Related Posts
Big changes to USGS Water Data in 2025
May 28, 2025
Public USGS Webinar: Water Data for the Nation – New Features and NWISWeb Decommissioning
In this webinar, we highlight important changes in how we deliver water data. These changes are part of a long-term effort to modernize our Water Data for the Nation (WDFN) systems, improve performance, and better serve both internal and public users.
What's new with WDFN APIs?
May 21, 2025
Public USGS Webinar: Water Data for the Nation – New Features and NWISWeb Decommissioning
In this webinar, we highlight important changes in how we deliver water data. These changes are part of a long-term effort to modernize our Water Data for the Nation (WDFN) systems, improve performance, and better serve both internal and public users.
WaterServices APIs will be decommissioned early 2027
January 7, 2026
We have released modernized Water Data APIs which will supersede the WaterServices family of APIs. WaterServices will be decommissioned in the first quarter of 2027. We will have more information about the decommission process, which may include intentional service degradation and blackouts, in the second half of 2026. We will not begin any intentional degradation of these services before August 2026.
Metadata in Water Data for the Nation
December 29, 2025
Introduction
Metadata are crucial to interpreting and understanding USGS water data. Metadata are data that provides information about other data. They provide important context to the water data you are viewing on WDFN pages or downloading from USGS Water Data APIs . USGS water data metadata includes codes and abbreviations, such as parameter codes, method codes, and observed properties.
Daily data in Water Data for the Nation
November 21, 2025
There have been a lot of changes to how you access USGS water data as we work to modernize data delivery in WDFN and decommission NWISWeb. As we centralize and re-organize data delivery in WDFN, we have recently set out to describe different types of water data according to data collection categories . We started with re-organizing and expanding the data collection categories that are delivered on the Monitoring Location Page and are now working to deliver additional data collection categories on other WDFN pages as well. This blog is part of a series to help orient you to where you can find different types of data in WDFN pages and services. In this post, we want to focus on how you can access daily data in WDFN.