Use the API

For Developers

HydroShare has a public RESTful web-service Application Programming Interface (API). This has been developed with the intent of enabling many of the functions that are accessible through the web user interface, to be done programmatically.  The API follows OpenAPI standards and is documented at


There is a Python Client Library to simplify the use of the API from Python.  It can be obtained from PyPI, the Python Package Index (pip install hs_restclient).  Documentation is at, and the source code is in GitHub)


There is an example Jupyter Notebook that can run on CUAHSI HydroShare that illustrates use of the Python client.

HydroShare Python Client Library (hsclient) Usage Examples