View water level data

get https://dashboard.hohonu.io/api/v1/stations/{stationId}/waterlevel

View water level data for a specific station.

NOTE - You may only request data within a 30 day range per call. Requesting data outside of this range will result in a 403.

Path Params

stationId

string

required

unique identifier of the station

Query Params

from

string

required

Start date of request data.

string

required

Stop date of request data.

units

string

Defaults to english

The units of water level observations. english returns data in feet, while metric returns data in meters.

datum

string

Defaults to D2W

The datum the data are referenced to.

Different datum options may be available for a station depending on the deployment type and installation history. If you pass a datum string that the station is not able to display, this will result in an error with the listed datums supported by that specific station.

D2W (Distance to Water)
Also known as the station datum. D2W measurements are simply how far away the water level is from the installed sensor. It is not an indication of the absolute height of the water, and should not be used as a way to compare to other locations.

NAVD (North American Vertical Datum of 1988)
A geodetic datum (such as NAVD88) is an abstract coordinate system with a reference surface (such as sea level) that serves to provide known locations to begin surveys and create maps.

MLLW (Mean Lower Low Water) / MHHW (Mean High High Water)
MLLW is the most common tidal datum, and reflects what you would see in a standard tide app.
MHHW is commonly used for monitoring storm surge and inundation.
Learn more about datums.

If tidal datums (MLLW, MHHW) are unavailable, the station may still be in the process of being deployed and configured.

FLOOD_DEPTH (Depth of Inundation)
Flood depth data are referenced to the surveyed NAVD88 station and ground heights, and measurements greater than 0 generally indicate the presence of inundation.

Only available for above ground deployments.

WATER_DEPTH (Water Depth)
Water depth data are referenced to the surveyed NAVD88 station and distance to the bottom.

Only available for water depth deployments.

qc_level

integer

Defaults to 1

Quality level of processed data to return. Stations deployed over water and over land have different QC methods applied to them.
Learn more about our QC process. Only a single quality level is available for NOAA gages.

(0) Data with no post-processing, taken directly from sensor measurements.
(1) For tidal stations, these data have undergone QARTOD testing to identify, remove, and interpolate bad data points. For land stations,this returns aata with marginal levels of processing. Data points near the sensor, near the ground, and below ground height are replaced with the datum value
(2) For land stations only. These data are of the highest level of processing. Includes the same filtering as (1) plus removal of spikes, large gradients, and above ground measurements collected outside of times of extremely high tides or other known drivers of flooding.

flags

boolean

Defaults to false

Whether to show QC flags for each data point. Flags are only available for qc_level > 0 for Hohonu gages.
Flags are returned in the form of a comma separated string of integers, where each value represents individual QC test results.

Flag integers can take on the value of:

(1): PASS
(4): FAIL
(9): MISSING

The returned flag string differs for each deployment type and qc_level. For more details on the specific QC tests mentioned below, please see here.

Deployment Type: Tidal / Over Water; qc_level >= 1
String: X,X,X,X,X,X where X is an individual QC Flag value for the following tests:
- Gap Test
- Gross Range Test
- Spike Test
- Flat Line Test
- Rate of Change Test
- Forecast (Neighbor) Test

Depolyment Type: Over Land; qc_level = 1
String: X where X is an individual QC Flag value for the following tests:
- Gross Range Test

Deployment Type: Over Land; qc_level = 2
String: Y,X,X,X where Y is the value of the boolean status flag reflecting whether the QC process has been reapplied to the dataset at the end of the day, and X is an individual QC Flag value (i.e. 1, 3, 4, or 9) for the following tests:
- Spike Test
- Rate of Change Test
- Climatology Test

predictions

boolean

Defaults to false

Show predictions (presently only available for NOAA data).

Responses

200Station water level.

400Error with request

404station id not found