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

# Get current speed timeline for a location

`GET /currents/timeline`

## Request

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

Returns signed current speed every 10 minutes for the nearest current station, skipping stations with no model and refused with 451 when that station's source forbids redistributing its predictions. 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

- CurrentTimelineResponse
  - `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)
  - `timeline` CurrentTimelineEntry[], required
    - `time` string, date-time, required
    - `hour` number: Hours since the first sample
    - `speed` number, required: Signed knots along the flood axis: positive flood, negative ebb

## 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)