---
title: "Get current speed timeline for a specific station"
method: GET
path: "/currents/stations/{source}/{id}/timeline"
---

# Get current speed timeline for a specific station

`GET /currents/stations/{source}/{id}/timeline`

## Request

- Base URL: `https://api.openwaters.io`
- URL: `https://api.openwaters.io/currents/stations/{source}/{id}/timeline`
- Auth: none required

Get current speed timeline for a specific station

## Path parameters

- `source` string, required
- `id` string, required

## Query parameters

- `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
- `404`: Station or bin not found, or the station has no model to predict from
- `451`: The 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)