latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

Alerts

Get all alerts of the current user's feed

Current Endpoint Behavior

Retrieve all alerts for targets that are in collections with feed delivery enabled.

This endpoint returns paginated alerts filtered by various criteria. Alerts are returned for targets that belong to collections where feed delivery is enabled. Results are ordered by newest first.

Response: Returns a paginated list of alert objects. Each alert includes basic information (id, uuid, title, timestamps), event grouping, priority and classification details, location/geographic data, source links and media, infotags, primary target information, and collection paths. The response is wrapped in a Spring Data Page object with standard pagination fields. See the response schema for complete field definitions.

Note: Fields with null values are omitted from the JSON response. This is standard JSON serialization behavior. Geographic information (geo) is only available if includeGeo query parameter is set to true.

Required Permission: access_public_user_feed

Performance Impact: Medium

get/public/v1/feed

Query parameters

collectionIdinteger[]

Collection IDs to filter the feed by. Only alerts for targets in these collections will be returned. Obtain collection IDs from GET /public/v1/collections endpoint.

newerThaninteger

⚠️ DEPRECATED - Use from parameter instead. Only return alerts that are newer than the given timestamp (Timestamp in milliseconds). This parameter is deprecated in favor of ISO 8601 date format.

fromstring date-time

Only return alerts that are newer than the given date. Use ISO 8601 format (e.g., 2020-12-31T23:59). This parameter replaces the deprecated newerThan parameter.

perspectiveIdinteger

Perspective ID to filter the feed by. Defaults to the user's default perspective. The perspective determines which risk factors and scoring weights are applied to alerts.

prioritiesPriority[]

List of priorities to filter the feed by

includeGeoboolean

If set to true, the response will include the geo information.

impactLevelIdsinteger[]

Impact level IDs to filter the feed by. Only alerts with these impact levels will be returned.

pageinteger
sizeinteger
sortstring[]

Response

Successfully retrieved alerts

totalPagesinteger
totalElementsinteger
sizeinteger
numberinteger
firstboolean
lastboolean
numberOfElementsinteger
emptyboolean