Alerts

Get all alerts of the current user's feed

⚠️ DEPRECATED - This endpoint is deprecated and will be removed on May 31, 2027. Use GET /public/v2/feed instead.

Note: Responses include a Sunset HTTP header (RFC 8594) indicating the removal date.


Migration Required

Migrate to GET /public/v2/feed. Same required permission: access_public_user_feed.

V1V2
/public/v1/feed/public/v2/feed
collectionIdcollectionIds
from or newerThan (milliseconds)from only; UTC ISO 8601 (e.g. 2024-01-01T00:00:00Z)
Numeric timestamps in the responseISO 8601 UTC strings

V2 also adds to, timeFilterBy, minTier / maxTier, structured eventTypes / eventTypeGroups / alertTypes / labels (replacing infotags), and relevancy (replacing statusId). See the V2 operation documentation and the public API changelog (Q3 2026) for the full migration guide.


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
numberOfElementsinteger
firstboolean
lastboolean
emptyboolean

Changes

Changed in 4 of the 9 revisions of this API.415

    • response property content/items/locations/items/earliestAlert deprecated

      response-property-deprecated

    • response property content/items/primaryTargets/items/target/earliestAlert deprecated

      response-property-deprecated

  • d08b2fe6a84f42See the full diff
    • the response property content/items/locations/items/ctype/priority became nullable for the status 200

      response-property-became-nullable

    • the response property content/items/primaryTargets/items/target/ctype/priority became nullable for the status 200

      response-property-became-nullable

    • the response property content/items/locations/items/ctype/priority became optional for the status 200

      response-property-became-optional

    • the response property content/items/primaryTargets/items/target/ctype/priority became optional for the status 200

      response-property-became-optional

    • response property content/items/locations/items/ctype/priority deprecated

      response-property-deprecated

    • response property content/items/primaryTargets/items/target/ctype/priority deprecated

      response-property-deprecated

    • endpoint deprecated

      endpoint-deprecated

    • removed the optional property content/items/statusId from the response with the 200 status

      response-optional-property-removed