Incidents
The incidents endpoint returns OroraTech satellite detections and integrated incidents together in a single response, for all monitored areas of the user.
This is the recommended endpoint when both satellite fire data and integrated incident data are required, as it avoids the need to call multiple endpoints and reconcile overlapping results.
Response entries
Each entry in the response is one of:
- Fire cluster: detected by OroraTech.
- Fire cluster with integrated incidents: a fire cluster linked to one or more integrated incidents submitted by the organization. The integrated incidents are nested under
integrated_incidents. - Integrated incident only: an integrated incident that could not be matched to any fire cluster.
Endpoints
Two formats are available, both accepting the same query parameters (time range, fire confidence, cluster type, …):
- GET /v1/monitored_areas/my/incidents/ - returns a JSON array of incidents.
- GET /v1/monitored_areas/my/incidents/geojson/ - returns a GeoJSON FeatureCollection where each feature is a
Point. For satellite fires, the point is the cluster centroid. For integrated incidents, the point is the location of the integrated incident.
Examples
Fire cluster with an integrated incident
A fire cluster that has an integrated incident linked to it.
{
"id": 37854730,
"source": "ororatech",
"monitored_areas": [
{
"id": 35919,
"creator_id": 2745,
"area_name": "California North"
}
],
"cluster": {
"id": 102446369,
"num_hotspots": 14,
"centroid": {
"lat": 37.115,
"lon": -120.428
},
"newest_acquisition": "2026-05-30T19:51:23Z",
"oldest_acquisition": "2026-05-30T07:22:10Z",
"total_area": 68019.96,
"max_frp": 1.49,
"fire_confidence": "medium",
"is_merged": false
},
"type": "forest",
"cause": "unknown",
"status": "new",
"created_at": "2026-05-30T22:19:22Z",
"pinned": false,
"is_updated": true,
"integrated_incidents": [
{
"id": 5014,
"external_identifier": "INC-2026-001",
"external_source": "CalFire",
"start": "2026-05-30T08:00:00Z",
"last_activity": "2026-05-30T20:00:00Z",
"status": "dispatched",
"type": "forest"
}
]
}
GeoJSON response
The GeoJSON endpoint wraps the same data in a FeatureCollection. Each feature carries the full incident metadata in its properties.
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-120.428, 37.115]
},
"properties": {
"id": 37854730,
"source": "ororatech",
"monitored_areas": [
{
"id": 35919,
"creator_id": 2745,
"area_name": "California North"
}
],
"cluster": {
"id": 102446369,
"num_hotspots": 14,
"centroid": {
"lat": 37.115,
"lon": -120.428
},
"newest_acquisition": "2026-05-30T19:51:23Z",
"oldest_acquisition": "2026-05-30T07:22:10Z",
"total_area": 68019.96,
"max_frp": 1.49,
"fire_confidence": "medium",
"is_merged": false
},
"type": "forest",
"cause": "unknown",
"status": "new",
"created_at": "2026-05-30T22:19:22Z",
"pinned": false,
"is_updated": true,
"integrated_incidents": [
{
"id": 5014,
"external_identifier": "INC-2026-001",
"external_source": "CalFire",
"start": "2026-05-30T08:00:00Z",
"last_activity": "2026-05-30T20:00:00Z",
"status": "dispatched",
"type": "forest"
}
]
}
}
]
}
Switching from the clusters endpoint
If you are currently using GET /v1/clusters/ or GET /v1/monitored_areas/my/clusters/, switch to GET /v1/monitored_areas/my/incidents/ to also include integrated incidents in the response.
The incidents endpoint requires at least one active monitored area. If you rely on bounding-box searches without monitored areas, continue using the clusters endpoint.