Perigee

Generated from OpenAPI 3.1

API reference

OpenAPI drives this generated reference, shared errors, authentication, quota headers, and SDK contracts. The playground offers a curated set of runnable operations.

OpenAPI JSONTry it

Stations

3 operations
GET
/api/v1/stations

Search the NOAA station directory

PUBLIC
GET
/api/v1/stations/nearest

Find stations nearest a coordinate

PUBLIC
GET
/api/v1/stations/{id}

Get station metadata, products, datums, and flood levels

PUBLIC

Observations

4 operations
GET
/api/v1/stations/{id}/predictions

Get high/low or interval tide predictions

PUBLIC
GET
/api/v1/stations/{id}/water-levels

Get observed water levels

PUBLIC
GET
/api/v1/stations/{id}/conditions

Get latest water, wind, temperature, and pressure readings

PUBLIC
GET
/api/v1/stations/{id}/forecast

Get NWS wind and marine forecast context

PUBLIC

Astronomy

1 operation
GET
/api/v1/astronomy

Calculate sun and moon details for a coordinate

PUBLIC

Decisions

4 operations
POST
/api/v1/decisions/trip-health

Get one explainable Trip Health planning read

PUBLIC
POST
/api/v1/decisions/best-window

Rank 2–12 candidate local windows

KEY
POST
/api/v1/decisions/evaluate-rules

Evaluate deterministic rules against a fresh planning decision

KEY
POST
/api/v1/decisions/material-change

Compare a prior decision summary with current inputs

KEY

Platform

1 operation
GET
/api/developer/status

Get API, MCP, and upstream provider status

PUBLIC

Authentication and limits

Use Authorization: Bearer pg_live_… or x-api-key. Every response returns request, minute-limit, and monthly-quota headers. A 429 is deterministic; a 503 means Perigee could not safely reserve commercial quota and failed closed.