v4

latestOpenAPI 3.1.0Proprietary2026-08-034715226.2 KB
events

Events as GeoJSON

Returns events as a GeoJSON FeatureCollection. Requires Starter+ plan.

Ordering (not configurable): the same as /events — severity first, then last_updated descending, tie-broken by id descending.

This matters more here than on /events, because this endpoint always truncates at limit and has no pagination: the ordering decides what a map can draw at all. Severity-first guarantees the most serious events survive the cut. It was previously ordered by last_updated alone, which on a large active set could return a page containing no critical events whatsoever.

get/events/geojson

Query parameters

jurisdictionstring

Filter by jurisdiction code (e.g., GA, ON, CA). Required on Free plan.

Auto-expansion: querying a state's primary code that has WZDx/CWZ or sub-state regional siblings (see GET /jurisdictions/groups) is expanded transparently to include all members. For example, ?jurisdiction=CA returns rows from CA, WZDX_CA, and 511SF.

To opt out, query a non-primary code directly (?jurisdiction=WZDX_CA returns WZDx-only rows) or pass a comma-separated list explicitly (?jurisdiction=CA,WZDX_CA), which bypasses expansion and matches each code literally.

bboxstring

Bounding box: minLng,minLat,maxLng,maxLat

latnumber

Latitude for radius search

lngnumber

Longitude for radius search

radius_kmnumber

Radius in km (used with lat/lng).

Capped at 200 when combined with group. A group expands to many feature types, and a wide radius over all of them cannot be served inside the request budget, so the combination returns 400 rather than timing out. Lower the radius, or query a single type — single-type radius searches have no limit.

typestring
severitystring
status'active' | 'archived' | 'all'

active (default) returns active events, archived returns archived events only, all disables the filter and returns both.

/events/geojson exposes no start_time_from parameter, so for callers on plans without analytics access (allow_analytics: false) the effective allowed values collapse to active only — requesting archived or all returns 403. Plans with analytics access are unrestricted.

Response

GeoJSON FeatureCollection