{
  "service": "alertq",
  "status": "beta: the answers are live, but their shape may still change before apps rely on it",
  "description": "Public weather alerts near a point, from NWS and Environment Canada in one answer.",
  "usage": [
    "GET /49.0,-123.07                   -- alerts in effect within 25 km: inside first, then nearest",
    "GET /?lat=49.0&lon=-123.07&within=50 -- a radius from 1 to 100 km",
    "GET /49.0,-123.07?geometry=full     -- with each alert's nearest area as GeoJSON",
    "GET /alerts                          -- every alert in effect, without shapes",
    "GET /alerts?source=eccc              -- from one source: nws, eccc or eccc-marine",
    "GET /alerts/nws:KJAX.RP.S.0033.2026  -- one alert: its parts and areas with shapes, every version sent, its events",
    "GET /alerts/nws:KJAX.RP.S.0033.2026?geometry=none -- without the shapes",
    "GET /events?since=2026-11-01T00:00:00Z -- every alert's events seen after since, oldest first, 500 a page",
    "GET /sources                         -- how each feed is doing: last read, last pass, last error",
    "GET /alerts/{id} in a browser         -- the alert's page: its map, words, versions and history"
  ],
  "events": [
    "issued",
    "updated",
    "extended",
    "grown",
    "shrunk",
    "cancelled",
    "upgraded",
    "expired"
  ],
  "note": "Every alert is its agency's own, in its own words and levels: warning, watch, advisory or statement. What only one agency has, like NWS's VTEC or Environment Canada's risk colour, rides on that alert's source.",
  "terms": "Free and unsupported, not for volume, as is. Send a User-Agent. https://almanac.observer/#use"
}