---
title: "Marine Weather"
method: GET
path: "/marine.json"
tags: ["Marine"]
---

# Marine Weather

`GET /marine.json`

Returns marine and sailing weather forecast (up to 7 days depending on plan) including tide data (Pro+ and above), wave height, swell, and water temperature.

## Query parameters

- `key` string, required
- `q` string, required
- `days` integer, required
- `dt` string, date
- `hour` integer
- `tides` 'yes' | 'no'

## Response `200`

Marine weather data

- MarineWeatherResponse
  - `location` Location — Location metadata returned with every weather response.
    - `name` string — Location name
    - `region` string — Region or state
    - `country` string — Country name
    - `lat` number, float — Latitude
    - `lon` number, float — Longitude
    - `tz_id` string — IANA timezone ID, e.g. Europe/London
    - `localtime_epoch` integer — Local time as Unix epoch
    - `localtime` string — Local date and time string
  - `forecast` object
    - `forecastday` MarineForecastDay[]
      - `date` string, date
      - `date_epoch` integer
      - `day` ForecastDay
        - `maxtemp_c` number
        - `maxtemp_f` number
        - `mintemp_c` number
        - `mintemp_f` number
        - `avgtemp_c` number
        - `avgtemp_f` number
        - `maxwind_mph` number
        - `maxwind_kph` number
        - `totalprecip_mm` number
        - `totalprecip_in` number
        - `totalsnow_cm` number
        - `avgvis_km` number
        - `avgvis_miles` number
        - `avghumidity` integer
        - `daily_will_it_rain` integer
        - `daily_chance_of_rain` integer
        - `daily_will_it_snow` integer
        - `daily_chance_of_snow` integer
        - `condition` Condition
          - `text` string — Weather condition description
          - `icon` string — URL to condition icon
          - `code` integer — Condition code (see conditions.json)
        - `uv` number
        - `air_quality` AirQuality — Air quality data. Returned when aqi=yes.
          - `co` number — Carbon monoxide µg/m³
          - `o3` number — Ozone µg/m³
          - `no2` number — Nitrogen dioxide µg/m³
          - `so2` number — Sulphur dioxide µg/m³
          - `pm2_5` number — PM2.5 µg/m³
          - `pm10` number — PM10 µg/m³
          - `us-epa-index` integer — US EPA index 1–6 (1=Good, 6=Hazardous)
          - `gb-defra-index` integer — UK DEFRA index 1–10
      - `astro` AstroElement
        - `sunrise` string
        - `sunset` string
        - `moonrise` string
        - `moonset` string
        - `moon_phase` string
        - `moon_illumination` number
        - `is_moon_up` integer
        - `is_sun_up` integer
      - `tides` object[]
        - `tide` Tide[]
          - `tide_time` string
          - `tide_height_mt` number
          - `tide_type` 'High' | 'Low'
      - `hour` MarineHour[]
        - `time_epoch` integer
        - `time` string
        - `temp_c` number
        - `temp_f` number
        - `is_day` integer
        - `condition` Condition
          - `text` string — Weather condition description
          - `icon` string — URL to condition icon
          - `code` integer — Condition code (see conditions.json)
        - `wind_mph` number
        - `wind_kph` number
        - `wind_degree` integer
        - `wind_dir` string
        - `pressure_mb` number
        - `pressure_in` number
        - `precip_mm` number
        - `precip_in` number
        - `snow_cm` number
        - `humidity` integer
        - `cloud` integer
        - `feelslike_c` number
        - `feelslike_f` number
        - `windchill_c` number
        - `windchill_f` number
        - `heatindex_c` number
        - `heatindex_f` number
        - `dewpoint_c` number
        - `dewpoint_f` number
        - `will_it_rain` integer
        - `chance_of_rain` integer
        - `will_it_snow` integer
        - `chance_of_snow` integer
        - `vis_km` number
        - `vis_miles` number
        - `gust_mph` number
        - `gust_kph` number
        - `uv` number
        - `short_rad` number
        - `diff_rad` number
        - `et0` number — Evapotranspiration (Business+)
        - `air_quality` AirQuality — Air quality data. Returned when aqi=yes.
          - `co` number — Carbon monoxide µg/m³
          - `o3` number — Ozone µg/m³
          - `no2` number — Nitrogen dioxide µg/m³
          - `so2` number — Sulphur dioxide µg/m³
          - `pm2_5` number — PM2.5 µg/m³
          - `pm10` number — PM10 µg/m³
          - `us-epa-index` integer — US EPA index 1–6 (1=Good, 6=Hazardous)
          - `gb-defra-index` integer — UK DEFRA index 1–10
        - `pollen` Pollen — Pollen data in grains/m³. Returned when pollen=yes (Pro+ and above).
          - `Hazel` number
          - `Alder` number
          - `Birch` number
          - `Oak` number
          - `Grass` number
          - `Mugwort` number
          - `Ragweed` number

## Other responses

- `400` — Bad request — invalid parameter or location not found.
- `401` — Unauthorized — API key missing or invalid.
- `403` — Forbidden — API key quota exceeded, disabled, or plan does not include this resource.

---

[API](https://skmtc.dev/weatherapi/apis/weatherapi-com.md) · [All operations](https://skmtc.dev/weatherapi/apis/weatherapi-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/weatherapi/weatherapi-com/revisions/bf3da15deb3e/schema)