---
title: "Tidal Residual Predict"
method: POST
path: "/api/v1/tidal-residual/predict"
tags: ["Tidal Residual Predictor"]
---

# Tidal Residual Predict

`POST /api/v1/tidal-residual/predict`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/tidal-residual/predict`
- Auth: none declared

Predict tidal residual at a NOAA CO-OPS station.

Fuses atmospheric pressure (inverted barometer), wind setup,
and river discharge proxy into a residual forecast.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Request body

- TidalResidualPredictRequest: Request for tidal residual prediction at a NOAA station.
  - `station_id` string: NOAA CO-OPS station ID (e.g. 8518750 for The Battery NYC)
  - `hours_lookback` integer: Hours of historical data to analyze
  - `forecast_hours` integer: Hours ahead to predict residual

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)