---
title: "Weather forecast for harbor"
method: GET
path: "/api/v1/weather/forecast"
tags: ["Weather"]
---

# Weather forecast for harbor

`GET /api/v1/weather/forecast`

## Request

- Base URL: `http://localhost:3002`
- URL: `http://localhost:3002/api/v1/weather/forecast`
- Auth: HTTP bearer

Returns the current NOAA weather forecast for a harbor's coordinates.

## Query parameters

- `harborId` string, required: Harbor ID to fetch forecast for

## Response `200`

Weather forecast

- object
  - `data` WeatherForecast, required
    - `forecast` string, required
    - `windSpeed` number, nullable
    - `waveHeight` number, nullable
    - `hasAdvisory` boolean, required
    - `advisoryType` string, nullable

## Other responses

- `400`: Request body or query parameters failed validation.
- `401`: Authentication required, or the bearer token is missing or invalid.
- `404`: The requested resource does not exist (existence is not leaked).

---

[API](https://skmtc.dev/chartercaptain/apis/charter-captain-api.md) · [All operations](https://skmtc.dev/chartercaptain/apis/charter-captain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chartercaptain/apis/charter-captain-api/revisions/1ffea1113adb?raw)