---
title: "Water Feature Endpoint"
method: POST
path: "/api/water-feature"
---

# Water Feature Endpoint

`POST /api/water-feature`

Get water feature (lake, river, or ocean) GeoJSON using vector search and S3.

This endpoint uses vector search to map natural language queries to water feature names,
then fetches the GeoJSON from S3.

Examples:
- "Lake Tahoe" -> Returns Lake Tahoe GeoJSON
- "Amazon River" -> Returns Amazon River GeoJSON
- "Pacific Ocean" -> Returns Pacific Ocean border GeoJSON
- With filter: {"query": "Superior", "feature_type": "lake"} -> Returns Lake Superior only

## Request body

- WaterFeatureRequest
  - `query` string, required — Natural language query for a water feature (e.g., 'Lake Tahoe', 'Amazon River', 'Pacific Ocean')
  - `feature_type` string, nullable — Optional filter for feature type: 'lake', 'river', or 'ocean'

## Response `200`

Successful Response

- APIResponse
  - `status` string, required
  - `data` object, nullable
  - `error` string, nullable
  - `timestamp` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/monarcha/apis/monarcha-gis-api.md) · [All operations](https://skmtc.dev/monarcha/apis/monarcha-gis-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monarcha/monarcha-gis-api/revisions/a2923fbc4d26/schema)