Returns a list of alerts generated by the Cannonball analysis system. Alerts are created when threats are detected, patterns are identified, or aircraft behavior changes significantly.
Parameter Type Description hoursinteger Time range in hours (default: 24) unacknowledgedboolean Only show unacknowledged alerts (default: false) alert_typestring Filter by alert type prioritystring Filter by priority: info, warning, critical acknowledgedboolean Filter by acknowledgement status
JSON
{
"alerts": [
{
"id": 1,
"session_icao": "A12345",
"alert_type": "le_detected",
"priority": "warning",
"title": "Law Enforcement Aircraft Detected",
"distance_nm": 2.5,
"acknowledged": false,
"created_at": "2024-01-15T12:30:00Z"
}
],
"count": 15,
"unacknowledged": 8
}Field Type Description idinteger Alert ID session_icaostring Aircraft ICAO hex from associated session alert_typestring Type of alert prioritystring Alert priority level titlestring Alert title distance_nmfloat Distance at time of alert acknowledgedboolean Whether alert has been acknowledged created_atstring Alert creation timestamp
Type Description le_detectedLaw enforcement aircraft detected pattern_detectedSuspicious flight pattern detected closing_fastAircraft approaching at high speed overheadAircraft directly overhead new_threatNew threat identified threat_escalatedThreat level increased threat_clearedThreat has departed or been cleared
Priority Description infoInformational alert warningWarning - increased attention recommended criticalCritical - immediate attention required
Bash
curl -X GET "https://api.skyspy.io/api/v1/cannonball/alerts/?unacknowledged=true&priority=critical" \
-H "Authorization: Bearer YOUR_TOKEN"Code Description 200 Success 401 Unauthorized - Invalid or missing authentication
