GET /api/v1/cannonball/alerts/

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.

Query Parameters

Parameter	Type	Description
`hours`	integer	Time range in hours (default: 24)
`unacknowledged`	boolean	Only show unacknowledged alerts (default: false)
`alert_type`	string	Filter by alert type
`priority`	string	Filter by priority: `info`, `warning`, `critical`
`acknowledged`	boolean	Filter by acknowledgement status

Response

{
  "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
}

Alert Object Fields (List View)

Field	Type	Description
`id`	integer	Alert ID
`session_icao`	string	Aircraft ICAO hex from associated session
`alert_type`	string	Type of alert
`priority`	string	Alert priority level
`title`	string	Alert title
`distance_nm`	float	Distance at time of alert
`acknowledged`	boolean	Whether alert has been acknowledged
`created_at`	string	Alert creation timestamp

Alert Types

Type	Description
`le_detected`	Law enforcement aircraft detected
`pattern_detected`	Suspicious flight pattern detected
`closing_fast`	Aircraft approaching at high speed
`overhead`	Aircraft directly overhead
`new_threat`	New threat identified
`threat_escalated`	Threat level increased
`threat_cleared`	Threat has departed or been cleared

Priority Levels

Priority	Description
`info`	Informational alert
`warning`	Warning - increased attention recommended
`critical`	Critical - immediate attention required

Example Request

curl -X GET "https://api.skyspy.io/api/v1/cannonball/alerts/?unacknowledged=true&priority=critical" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Codes

Code	Description
200	Success
401	Unauthorized - Invalid or missing authentication