Alerts

Platform alerts for sanctions matches, river level warnings, dark fleet events.

`GET` `/api/v1/alerts`

Requires API key.

Get active platform alerts. Filter by severity or type. Parameters

Name	Type	Description
`severity`	string	’critical’, ‘warning’, or ‘info’
`type`	string	’sanctions_match’, ‘river_level’, ‘dark_fleet’
`unacknowledged`	string	’true’ to only show unread alerts

Response

{ "alerts": [...], "count", "unacknowledged" }

Example

curl -X GET -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/alerts?severity=VALUE&type=VALUE

Requires API key.

Unified cross-product inbox combining maritime and Locus alerts in a single chronological feed. Parameters

Name	Type	Description
`product`	string	’all’ (default), ‘overwatch’, or ‘locus’
`severity`	string	’critical’, ‘warning’, or ‘info’
`watchlist`	string	’true’ to only include watched vessels
`portfolio`	string	Locus portfolio id filter
`state`	string	’all’ (default), ‘open’, ‘read’, ‘resolved’, ‘snoozed’
`cursor`	string	ISO cursor for pagination
`limit`	number	Default 25, max 100

Response

{ "alerts": [...], "count", "pagination": { "has_more", "next_cursor" }, "filters": {...} }

Example

curl -X GET -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/alerts/unified?product=VALUE&severity=VALUE

Requires API key.

Set per-user state for a unified alert (read, resolve, snooze, reopen). Parameters

Name	Type	Required	Description
`alert_id`	string	✓	Alert id in source:id format (e.g. dark_event:123)
`action`	string	✓	‘read’ \| ‘resolve’ \| ‘snooze’ \| ‘open’
`snooze_until`	string		ISO timestamp (optional for snooze; defaults to +24h)

Response

{ "ok": true, "alert_id", "action", "state": { "read_at", "resolved_at", "snoozed_until" } }

Example

curl -X POST -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/alerts/unified/state \
  -d '{"key":"value"}'