API Documentation

Every API request must include your API key in the X-API-Key header. Create and manage keys from the API Keys page.

curl -H "X-API-Key: tc_your_key_here" \
  https://tidecheck.com/api/station/9414290/tides

Returns tide predictions (extremes + continuous time series), sun/moon conditions, and daily forecasts for a given station.

curl -H "X-API-Key: tc_your_key_here" \
  "https://tidecheck.com/api/station/9414290/tides?datum=MLLW&days=7"

{
  "station": {
    "id": "9414290",
    "name": "San Francisco",
    "region": "California",
    "country": "United States",
    "lat": 37.8063,
    "lng": -122.4659,
    "type": "reference",
    "timezone": "America/Los_Angeles"
  },
  "datum": "MLLW",
  "extremes": [
    { "time": "2026-03-09T03:24:00.000Z", "localDate": "2026-03-08", "height": 1.842, "type": "high" },
    { "time": "2026-03-09T09:12:00.000Z", "localDate": "2026-03-09", "height": 0.156, "type": "low" }
  ],
  "timeSeries": [
    { "time": "2026-03-09T00:00:00.000Z", "height": 1.234 },
    { "time": "2026-03-09T00:15:00.000Z", "height": 1.301 }
  ],
  "conditions": {
    "sunrise": "2026-03-09T14:29:00.000Z",
    "sunset": "2026-03-10T02:12:00.000Z",
    "moonPhase": "Waxing Gibbous",
    "moonPhaseValue": 0.352,
    "moonIllumination": 68,
    "tidalStrength": "Moderate",
    "tidalStrengthValue": 0.55,
    "springNeap": "Neap",
    "moonCalendar": [
      { "type": "full", "name": "Full Moon", "date": "2026-03-12T..." }
    ]
  },
  "dailyConditions": [
    {
      "date": "2026-03-09",
      "sunrise": "2026-03-09T14:29:00.000Z",
      "sunset": "2026-03-10T02:12:00.000Z",
      "moonPhase": "Waxing Gibbous",
      "moonPhaseValue": 0.352,
      "moonIllumination": 68,
      "solunarRating": 3,
      "solunarLabel": "Good",
      "springNeap": "Neap"
    }
  ]
}

Search for stations by name, region, or country. Returns up to 10 results.

curl -H "X-API-Key: tc_your_key_here" \
  "https://tidecheck.com/api/stations/search?q=san+francisco"

[
  {
    "id": "9414290",
    "slug": "san-francisco",
    "name": "San Francisco",
    "region": "California",
    "country": "United States",
    "label": "San Francisco, California, United States"
  }
]

Find the 5 nearest stations to a latitude/longitude coordinate. Includes distance in kilometers.

curl -H "X-API-Key: tc_your_key_here" \
  "https://tidecheck.com/api/stations/nearest?lat=37.8063&lng=-122.466"

[
  {
    "id": "9414290",
    "slug": "san-francisco",
    "name": "San Francisco",
    "region": "California",
    "country": "United States",
    "lat": 37.8063,
    "lng": -122.4659,
    "label": "San Francisco, California, United States",
    "distanceKm": 0
  }
]

Geocode a place name to coordinates. Useful for finding the nearest station to a location by name.

curl -H "X-API-Key: tc_your_key_here" \
  "https://tidecheck.com/api/geocode?q=Bali"

[
  {
    "name": "Bali, Kabupaten Bangli, Bali, Indonesia",
    "lat": -8.4095,
    "lng": 115.1889,
    "type": "administrative"
  }
]

Combine endpoints to get tide predictions for any place name in 2 API calls:

# Step 1: Find the nearest station to a location
curl -H "X-API-Key: tc_your_key_here" \
  "https://tidecheck.com/api/stations/nearest?lat=-8.41&lng=115.19"

# Step 2: Get tide predictions using the station ID
curl -H "X-API-Key: tc_your_key_here" \
  "https://tidecheck.com/api/station/STATION_ID/tides?days=7"

const API_KEY = "tc_your_key_here";
const headers = { "X-API-Key": API_KEY };

// Find nearest station
const nearby = await fetch(
  "https://tidecheck.com/api/stations/nearest?lat=37.81&lng=-122.47",
  { headers }
).then(r => r.json());

const stationId = nearby[0].id;

// Get 7-day tide predictions
const tides = await fetch(
  `https://tidecheck.com/api/station/${stationId}/tides?days=7`,
  { headers }
).then(r => r.json());

// Next high tide
const nextHigh = tides.extremes.find(e =>
  e.type === "high" && new Date(e.time) > new Date()
);
console.log(`Next high: ${nextHigh.height}m at ${nextHigh.time}`);

import requests

API_KEY = "tc_your_key_here"
headers = {"X-API-Key": API_KEY}

# Search for a station
stations = requests.get(
    "https://tidecheck.com/api/stations/search",
    params={"q": "san francisco"},
    headers=headers
).json()

# Get tide predictions
tides = requests.get(
    f"https://tidecheck.com/api/station/{stations[0]['id']}/tides",
    params={"datum": "MLLW", "days": 7},
    headers=headers
).json()

for extreme in tides["extremes"][:5]:
    kind = "High" if extreme["type"] == "high" else "Low"
    print(f"{kind}: {extreme['height']}m at {extreme['time']}")

Need higher limits? Contact us or upgrade your plan.

Heights are returned relative to the requested vertical datum. Choose based on your use case: