---
title: "Get timeline prediction for a location"
method: GET
path: "/tides/timeline"
---

# Get timeline prediction for a location

`GET /tides/timeline`

## Request

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

Returns water level predictions at regular intervals for the nearest station

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `start` string, date-time
- `end` string, date-time
- `datum` 'CD' | 'CRD_OFFSET' | 'DHQ' | 'DLQ' | 'DTL' | 'GT' | 'GUVD04' | 'HAT' | 'HWI' | 'LAT' | 'LLWLT' | 'LWI' | 'MHHW' | 'MHW' | 'MHWN' | 'MHWS' | 'MLLW' | 'MLW' | 'MLWN' | 'MLWS' | 'MN' | 'MSL' | 'MTL' | 'NAVD88' | 'NLLW' | 'NMVD03' | 'NN2000' | 'PRVD02' | 'STND' | 'TLT' | 'VIVD09'
- `units` 'meters' | 'feet'

## Response `200`

Successful prediction

- TimelineResponse
  - `datum` string
  - `units` 'meters' | 'feet'
  - `station` Station
    - `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
  - `distance` number
  - `timeline` TimelineEntry[]
    - `time` string, date-time, required
    - `level` number, required

## Other responses

- `400`: Invalid parameters

---

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