Skip to content
Docs navigation

Observations and soundings

Smarter Weather covers the 50 US states and DC only. Coverage details

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.

GET /v1/lightning returns recent lightning near a point: the GOES GLM flash count plus MRMS lightning density and probability. It is experimental, and a zero flash count is not yet a guaranteed all-clear. See the reference below or the full API reference.

curl "https://api.smarterweather.com/v1/observations/nearest?lat=42.3601&lon=-71.0589&n=3" \
  -H "Authorization: Bearer ${SMARTERWEATHER_API_KEY:?set SMARTERWEATHER_API_KEY first, see developers.smarterweather.com/quickstart}"
// save as sample.mjs; run: node --env-file=.env sample.mjs (Node 20.6+, ESM top-level await)
const res = await fetch(
  "https://api.smarterweather.com/v1/observations/nearest?lat=42.3601&lon=-71.0589&n=3",
  { headers: { Authorization: `Bearer ${process.env.SMARTERWEATHER_API_KEY}` } },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
console.log(JSON.stringify(data, null, 2));
# pip install requests python-dotenv
import os, sys, requests
from dotenv import load_dotenv

load_dotenv(".env")  # ./.env in the current directory; variables already set are kept

r = requests.get(
    "https://api.smarterweather.com/v1/observations/nearest",
    params={"lat":"42.3601","lon":"-71.0589","n":"3"},
    headers={"Authorization": f"Bearer {os.environ['SMARTERWEATHER_API_KEY']}"},
)
if not r.ok:
    sys.exit(f"{r.status_code} {r.text}")
data = r.json()
print(data)
package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.smarterweather.com/v1/observations/nearest?lat=42.3601&lon=-71.0589&n=3", nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SMARTERWEATHER_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	body, err := io.ReadAll(res.Body)
	if err != nil {
		log.Fatal(err)
	}
	if res.StatusCode < 200 || res.StatusCode > 299 {
		log.Fatalf("%s %s", res.Status, body)
	}
	fmt.Println(string(body))
}

Samples read your key from SMARTERWEATHER_API_KEY. Set it up in the Quickstart.

Observations and soundings reference

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

Paste a test key (sw_test_*) from your dashboard into Test Request. Test keys are never billed; their calls still count toward the key's rate limits and daily cap. Calls with your own live key count toward your plan.

Loading the API reference… The spec is also in openapi.yaml.