---
title: "Get current events for a location"
method: GET
path: "/currents/events"
---

# Get current events for a location

`GET /currents/events`

## Request

- Base URL: `https://api.openwaters.io`
- URL: `https://api.openwaters.io/currents/events`
- Auth: none required

Returns slack water, maximum flood, and maximum ebb between start and end for the nearest current station, skipping stations with no model. When that station's source forbids redistributing its predictions the request is refused with 451 rather than answered from a station farther away. end must be within 366 days of start.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `start` string, date-time
- `end` string, date-time

## Response `200`

Successful prediction

- CurrentEventsResponse
  - `units` 'knots', required
  - `floodDirection` number: Degrees true, when the station has one
  - `ebbDirection` number: Degrees true, when the station has one
  - `station` CurrentStation, required
    - `id` string
    - `name` string
    - `latitude` number
    - `longitude` number
    - `region` string
    - `country` string
    - `continent` string
    - `timezone` string
    - `type` 'reference' | 'subordinate'
    - `source` object
      - `id` string
      - `name` string
      - `url` string
    - `license` object
      - `type` string
      - `commercial_use` boolean
      - `url` string
      - `notes` string
    - `disclaimers` string
    - `distance` number: Distance from query point in kilometers (only for proximity searches)
    - `datums` object
      - `CD` number
      - `CRD_OFFSET` number
      - `DHQ` number
      - `DLQ` number
      - `DTL` number
      - `GT` number
      - `GUVD04` number
      - `HAT` number
      - `HWI` number
      - `LAT` number
      - `LLWLT` number
      - `LWI` number
      - `MHHW` number
      - `MHW` number
      - `MHWN` number
      - `MHWS` number
      - `MLLW` number
      - `MLW` number
      - `MLWN` number
      - `MLWS` number
      - `MN` number
      - `MSL` number
      - `MTL` number
      - `NAVD88` number
      - `NLLW` number
      - `NMVD03` number
      - `NN2000` number
      - `PRVD02` number
      - `STND` number
      - `TLT` number
      - `VIVD09` number
    - `harmonic_constituents` object[]
      - `name` string
      - `amplitude` number
      - `phase` number
    - `defaultDatum` string
    - `offsets` object
      - `reference` string
      - `height` object
        - `high` number
        - `low` number
        - `type` 'ratio' | 'fixed'
      - `time` object
        - `high` number
        - `low` number
    - `bins` CurrentBin[], required: Every depth bin of this station, primary first
      - `id` string, required: Station ID for this bin
      - `bin` integer: Bin number; absent for the primary bin, which the bare station ID selects
    - `predictions` boolean, required: Whether this API can serve predictions for the station
    - `unavailable` string: Why predictions can't be served, when `predictions` is false
    - `kind` 'current'
    - `current` object
      - `flood_direction` number: Degrees true
      - `ebb_direction` number: Degrees true
      - `mean_flow` number: Knots
      - `offsets` object: Subordinate stations only. Times in minutes, ratios dimensionless.
        - `reference` string
        - `slack_before_flood` number
        - `slack_before_ebb` number
        - `flood_time` number
        - `ebb_time` number
        - `flood_speed_ratio` number
        - `ebb_speed_ratio` number
  - `distance` number: Distance from the query point in kilometers (location queries only)
  - `events` CurrentEvent[], required
    - `time` string, date-time, required
    - `speed` number, required: Signed knots along the flood axis: positive flood, negative ebb. Slack carries the near-zero residual.
    - `kind` 'slack' | 'maxFlood' | 'maxEbb', required
    - `direction` number: Flood or ebb direction in degrees true; absent for slack and when the station has none

## Other responses

- `400`: Invalid parameters
- `451`: The nearest current station's source does not allow its predictions to be redistributed

---

[API](https://skmtc.dev/openwaters/apis/open-waters-api.md) · [All operations](https://skmtc.dev/openwaters/apis/open-waters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openwaters/apis/open-waters-api/revisions/851f87484fec?raw)