Incidents

List incidents

List and filter real-time incidents.

Supports hierarchical filtering: type (incident category), event_type (specific event category), event_subtype (granular subtype), plus status, state, severity, source, boundary intersection, radius search, and time range.

Both type and status accept comma-separated values for multi-value filtering (e.g. ?status=active,upcoming or ?type=traffic,fire).

Ordering: Radius queries default to closest-first (sort=distance) and include distance_km in each result. Use sort=newest to revert to newest-first ordering. Non-spatial queries always order by newest first.

Time range filters: since/until filter on started_at, ends_after/ends_before filter on expected_end_at (useful for finding planned outages within a window).

Each incident includes structured location fields: locality (suburb/area name), road_name (affected road), and location_detail (free-text location description).

Set detail=true to include full geometry, description, and raw source data per incident (same fields as the single-incident detail endpoint).

get/v1/data/incidents

Request

  • Base URL: https://api.mapulus.com
  • URL: https://api.mapulus.com/v1/data/incidents
  • Auth: HTTP bearer

Query parameters

typestring nullable

Filter by incident type (traffic, fire, power, weather). Comma-separated for multiple.

event_typestring nullable

Filter by event type (e.g. roadworks, crash, flood, fire_vegetation).

event_subtypestring nullable

Filter by event subtype (e.g. flash_flood, planned_roadworks, multi_vehicle).

statusstring

Filter by status (active, upcoming, resolved, expired). Comma-separated for multiple.

statestring nullable

Filter by state (QLD, NSW, etc.).

severitystring nullable

Filter by severity (minor, moderate, major, extreme).

sourcestring nullable

Filter by source_id.

boundary_idstring nullable

Incidents intersecting this boundary (e.g. lga:17200).

latnumber nullable

Latitude for radius search.

lngnumber nullable

Longitude for radius search.

radius_kmnumber nullable

Search radius in km (requires lat, lng).

sincestring nullable

Incidents started after this ISO datetime.

untilstring nullable

Incidents started before this ISO datetime.

ends_afterstring nullable

Incidents with expected_end_at after this ISO datetime.

ends_beforestring nullable

Incidents with expected_end_at before this ISO datetime.

detailboolean

Include full detail per incident (geometry, description, source data).

sortstring nullable

Sort order: 'distance' (closest first) or 'newest' (most recent first). Default: 'distance' for radius queries, 'newest' otherwise.

limitinteger

Page size.

offsetinteger

Pagination offset.

Response

Paginated list of incidents. Use detail=true for full geometry and source data.

Changes

No recorded changes to this operation across all 1 revision of this API.