Skip to content
Docs navigation

Agents as developers

Observations and soundings

Surface observations and upper-air soundings sampled at a point or at the nearest station. METAR collections come back as GeoJSON; nearest and sounding lookups return the station that actually reported.

Reach for these when a scheduling or aviation integration needs what was measured, not what is forecast — a METAR sky layer for a canvas, a sounding for a briefing, or the closest station to a field site.

curl "https://api.smarterweather.com/v1/observations?lat=42.3601&lon=-71.0589" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch(
  "https://api.smarterweather.com/v1/observations?lat=42.3601&lon=-71.0589",
  { headers: { Authorization: `Bearer ${process.env.SMARTERWEATHER_API_KEY}` } },
);
const data = await res.json();
import os, requests

data = requests.get(
    "https://api.smarterweather.com/v1/observations",,
    params={"lat":"42.3601","lon":"-71.0589"},
    headers={"Authorization": f"Bearer {os.environ['SMARTERWEATHER_API_KEY']}"},
).json()
req, _ := http.NewRequest("GET",
  "https://api.smarterweather.com/v1/observations?lat=42.3601&lon=-71.0589",
  nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("SMARTERWEATHER_API_KEY"))
res, _ := http.DefaultClient.Do(req)

Observations and soundings reference

Rendered live from the canonical OpenAPI document. This is the canonical reference for the observations and soundings resource.

Loading API reference…