PRODUCTS / UWA V1

One gateway.
Multiple data types.

Every data category has a clear canonical contract, independent routing rules, and explicit operational boundaries. Call categories together via GET /v1/datasets or individually.

One client integration across all 10 protected routes

Use GET /v1/datasets to request multiple categories for one location in a single HTTP call (with 207 Multi-Status partial-failure recovery), or call each category’s dedicated endpoint directly. The default lean_v1 profile exposes core routes; extended routes unlock under full_experimental in dev/test.

All 10 routes
8 PRODUCT FAMILIES · 10 PROTECTED ROUTESV1 CORE & EXPERIMENTAL PROFILES
01 / 08 · v1 core (lean_v1)
Observations

Current weather

Canonical observations, consistent Celsius units, 2-hour freshness guard and provider attribution.

ENDPOINTGET /v1/weatherREQUIRED SCOPEweather:readUPSTREAM CANDIDATESOpenWeather, WeatherAPI
Operational boundary

Requires an eligible configured upstream. Rejects observations older than 2 hours or coordinate drift beyond 50 km.

Read endpoint reference
02 / 08 · v1 core (lean_v1)
Model products

Forecasts

Bounded time steps (1–168 points) and sampled-point daily summaries.

ENDPOINTGET /v1/forecastREQUIRED SCOPEforecast:readUPSTREAM CANDIDATESMET Norway, Open-Meteo, US NWS, Bright Sky
Operational boundary

Predictions, not observations. Daily min/max (/v1/forecast/daily) are aggregated from sampled forecast points.

Read endpoint reference
03 / 08 · v1 core (lean_v1)
Location

Geocoding

Turn place queries into coordinates, and coordinates into places.

ENDPOINTGET /v1/geocodeREQUIRED SCOPEgeocode:readUPSTREAM CANDIDATESLocationIQ, Geoapify, Open-Meteo Geocoding, Nominatim
Operational boundary

Provider use, attribution, and caching are policy-controlled. Optional strict resolver powers place queries on weather and forecast routes.

Read endpoint reference
04 / 08 · v1 core (lean_v1 · opt-in)
Calculated events

Astronomy

Calculated solar and lunar events for a selected date with portable IANA timezone validation.

ENDPOINTGET /v1/astronomyREQUIRED SCOPEastronomy:readUPSTREAM CANDIDATESSunrise-Sunset.org
Operational boundary

Events are calculated; sunrise and sunset can be null at polar extremes. Requires explicit operator opt-in.

Read endpoint reference
05 / 08 · Experimental (full_experimental)
Model products

Air quality

Normalized air-pollutant concentration forecasts (PM2.5, PM10, NO2, O3, SO2, CO).

ENDPOINTGET /v1/air-qualityREQUIRED SCOPEair-quality:readUPSTREAM CANDIDATESOpen-Meteo Air Quality
Operational boundary

CAMS model predictions, not station-measured AQI; gated behind APP_RELEASE_PROFILE=full_experimental in development/test.

Read endpoint reference
06 / 08 · Experimental (full_experimental)
Reanalysis

Historical data

ERA5 reanalysis over bounded 1–7 UTC date ranges.

ENDPOINTGET /v1/historyREQUIRED SCOPEhistory:readUPSTREAM CANDIDATESOpen-Meteo History
Operational boundary

Reanalysis, not station measurements; gated behind APP_RELEASE_PROFILE=full_experimental in development/test.

Read endpoint reference
07 / 08 · Experimental (full_experimental)
Model products

Marine

Model-derived wave height, period and direction within 25 km of sea grids.

ENDPOINTGET /v1/marineREQUIRED SCOPEmarine:readUPSTREAM CANDIDATESOpen-Meteo Marine
Operational boundary

Forecast grid only; distant sea-grid cells (>25 km) are rejected. Gated behind APP_RELEASE_PROFILE=full_experimental.

Read endpoint reference
08 / 08 · Experimental (full_experimental)
Official alerts

Regional alerts

Official active US National Weather Service alert payloads.

ENDPOINTGET /v1/alertsREQUIRED SCOPEalerts:readUPSTREAM CANDIDATESUS NWS Alerts
Operational boundary

US-only and requires reviewed country polygons; gated behind APP_RELEASE_PROFILE=full_experimental.

Read endpoint reference

Release profile distinction: Current weather, forecast, daily forecast, geocoding, astronomy and /v1/datasets are active in the default lean_v1 profile. Air quality, history, marine and alerts require APP_RELEASE_PROFILE=full_experimental in development/test.

Search local documentation. No external requests.

↑↓ to move · Enter to openESC to close