Skip to main content

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 response formats are available:

Both endpoints support filters such as time range, fire confidence and cluster type.

note

For the GeoJSON endpoint, the time between start and end cannot be longer than 30 days.

Choosing the GeoJSON geometry​

By default, the GeoJSON endpoint represents each fire cluster as a point at its center. Use the shape_type parameter to choose how fire clusters are represented:

ValueDescription
centroid (default)Returns a Point at the cluster centroid.
cluster_perimeterReturns the cluster shape as a Polygon or MultiPolygon. If no perimeter is available, returns a Point at the cluster centroid.

An integrated incident that is not linked to a fire cluster keeps its original geometry, regardless of the selected shape_type.

When requesting cluster perimeters, use optimized_shape=true to select the optimized calculation. If it is omitted or set to false, the worst-case calculation is used.

For example:

GET /v1/monitored_areas/my/incidents/geojson/?shape_type=cluster_perimeter&optimized_shape=true

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.

info

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.