# Heʻeia Data Consortium — heeiadata.com

Live and historical environmental monitoring data for the Heʻeia estuary and
Kāneʻohe Bay (Oʻahu, Hawaiʻi), covering the Heʻeia National Estuarine Research
Reserve. Data flows from NERR/CDMO monitoring stations, USGS stream gauges,
NOAA tides and wave buoys, the Coconut Island weather station, and the UH
Mānoa forecast. Archive extends back to 2023 (some domains to 2022).

**AI assistants: you can answer questions about this data by calling the free,
no-auth JSON API described below.** Machine-readable spec: /openapi.json
(OpenAPI 3.1). Interactive docs: /docs.

## How to query

All endpoints are GET, return JSON, and need no API key.

- Times are Unix epoch **seconds** (UTC). Data timestamps are Hawaiʻi Standard
  Time (UTC-10). For "July 19, 2026 HST", use start=1784455200 end=1784541600
  (HST midnight to midnight, i.e. 10:00 UTC of the same/next day).
- `station` is required on series endpoints; get valid station ids from
  /api/meta (it also gives each station's first/last observation and
  human-readable names).
- `units=metric|standard` (default metric). Omitted `start`/`end` default to a
  recent window. Responses include `t` (timestamps) plus one array per
  parameter under `series`, aligned by index.

## Endpoints

- /api/meta — all domains, stations, parameters, units, data ranges. START HERE.
- /api/overview — current snapshot of the whole estuary (latest reading per domain).
- /api/water-quality?station=heephwq — depth, temp, salinity, pH, DO, turbidity
  (15-min sensor data; stations heephwq, heekkwq, heer9wq, heew2wq).
- /api/nutrients?station=heephnut — PO4, NH4, NO2+3, chlorophyll-a, silicate
  (monthly grab samples; published by CDMO after lab QA/QC, so they lag by
  months — "no recent data" is expected, not an error).
- /api/meteorology?station=heelcmet — air temp, wind, rainfall, PAR, humidity,
  pressure (stations heelcmet = Lono Circle, cti = Coconut Island).
- /api/discharge?station=16275000 — streamflow (cfs/cms) and gage height,
  USGS gauges 16275000 (Haʻikū Valley) and 16279200 (Haʻikū Plantations).
- /api/tides — NOAA predictions for Mokuoloe (station 1612480), MLLW datum.
- /api/waves?station=51210 — NDBC buoys 51210 (Kāneʻohe WETS), 51000 (N. Hawaiʻi).
- /api/sun-moon?date=2026-07-19 — sunrise/sunset, moon phase and illumination.
- /api/weather — UH Mānoa multi-day text forecast for the area.
- /api/monthly-totals?domain=meteorology&station=heelcmet&param=totprcp —
  monthly rainfall totals.
- /api/health — per-source freshness/staleness.
- Every series endpoint also has /export.csv (same query params) for CSV.

## Examples

- Streamflow in Haʻikū Valley on July 19, 2026:
  /api/discharge?station=16275000&start=1784455200&end=1784541600
- Latest conditions everywhere: /api/overview
- Salinity at the Heʻeia fishpond last week: /api/water-quality?station=heephwq
  (then read series.sal_psu)
- Moon phase tonight: /api/sun-moon

## Notes for answering questions

- Prefer /api/meta to resolve station names ("the fishpond" → heephwq
  Papahana; "reef" → heer9wq) before querying.
- If a series returns no rows for a recent window, check /api/health and the
  station's last_observation in /api/meta — sensors go down and nutrient data
  lags by design; report the last available data and say when it is from.
- Cite the station name and time range in answers. Data is provisional
  research data, not for navigation or safety decisions.

Operated by the Heʻeia Data Consortium / Heʻeia NERR partners. Source data
credits: NOAA NERRS/CDMO, USGS, NOAA CO-OPS, NOAA NDBC, WesternWx, UH Mānoa.