Environment

NOAA CO-OPS stations catalog

List CO-OPS stations. Default type=waterlevels returns the 301 primary National Water Level Observation Network (NWLON) stations covering all US coasts, the Great Lakes, Alaska, Hawaii, and territories (some with continuous records since 1856). Pass type=tidepredictions for the full 3,449-entry prediction catalog (primary stations plus subordinate offsets), type=currents for 88 current-meter stations in PORTS projects, or type=all for the unfiltered upstream set. Optional state 2-letter filter is applied client-side against Sugra's 24-hour in-process catalog cache. Attribution: NOAA CO-OPS Tides and Currents (api.tidesandcurrents.noaa.gov).

get/api/v1/environment/noaa-tides/stations

Query parameters

typestring

Catalog filter: waterlevels (301 primary gauges), tidepredictions (3,449 including subordinate), currents (88 PORTS current meters), or all.

statestring nullable

2-letter US state or territory code filter (e.g. NY, CA, HI). Case-insensitive.

limitinteger

Maximum number of station records to return (default 500, maximum 4000 to fit the 3,449-entry prediction catalog).

offsetinteger

Zero-indexed offset into the filtered list.

Response

Filtered station catalog listing with total and filtered counts.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 2 of the 22 revisions of this API.15

Sep 1, 2026328d061c12ca3See the full diff
- ○
  added the optional property meta/data_age_days to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/notes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/period to the response with the 200 status
  response-optional-property-added
Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history