Incidents

Search incidents by polygon

Search for incidents intersecting a GeoJSON geometry.

Send a GeoJSON Polygon or MultiPolygon in the request body. Optionally filter by incident type, status, and severity. Both type and status accept comma-separated values (e.g. "status": "active,upcoming"). Results include structured location fields (locality, road_name, location_detail).

Ordering: Defaults to closest-first (sort: "distance") based on the polygon centroid, with distance_km in each result. Use sort: "newest" for newest-first.

Set detail: true in the body to include full geometry, description, and raw source data per incident.

post/v1/data/incidents/search

Request

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

Request body

typestring[] nullable

Filter by incident types.

event_typestring nullable

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

event_subtypestring nullable

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

statusstring

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

severitystring nullable

Filter by severity.

sourcestring nullable

Filter by source_id.

statestring nullable

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

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 (geometry, description, source data).

sortstring nullable

Sort order: 'distance' or 'newest'. Default: 'distance'.

limitinteger
offsetinteger

Response

Incidents intersecting the provided geometry. Use detail=true for full data.

Changes

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