Alerts

Get alerts for a specific target

Retrieve alerts for a specific target identified by system ID and target ID.

This endpoint returns paginated alerts for a single target, supporting foreign system ID mapping. The target can be identified using Prewave internal IDs or foreign system IDs (e.g., customer, supplier, SAP IDs).

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.

Use Cases:

  • Monitor alerts for a specific supplier
  • Track alerts for targets identified by external system IDs
  • Filter alerts by priority, date, or perspective
  • Export target-specific alerts for reporting

Target Identification:

  • Supports Prewave internal IDs (systemId="prewave")
  • Supports foreign system IDs (e.g., systemId="customer", systemId="supplier")
  • Automatically resolves foreign IDs to Prewave target IDs

Filtering Options:

  • priorities: Filter by alert priority levels (Low, Mid, High, Critical)
  • newerThan: Filter alerts newer than a timestamp (milliseconds)
  • perspectiveId: Filter by perspective (defaults to user's perspective)
  • includeGeo: Include geographic coordinates in response

Pagination:

  • Results are paginated (default: 20 items per page)
  • Use page and size query parameters to control pagination

Required Permission: access_public_target_feed

Performance Impact: Medium

get/public/v1/target/{systemId}/{targetId}/alerts

Path parameters

systemIdstring required

An identifier that indicates which system the targetId originates from. Supported values are "prewave", "customer", "supplier", "own".

targetIdstring required

The target ID can be the target's prewaveId or an external id (edge number) representing the site in another system.

Query parameters

newerThaninteger

Only return alerts that are newer than the given timestamp (Timestamp in milliseconds since epoch)

prioritiesPriority[]

List of priorities to filter the feed by

includeGeoboolean

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

perspectiveIdinteger

The perspective ID to filter the alerts. If not provided, the user's perspective ID will be used.

pageinteger
sizeinteger
sortstring[]

Response

Successfully retrieved target alerts

sizeinteger
numberinteger
totalElementsinteger
totalPagesinteger
numberOfElementsinteger
firstboolean
lastboolean
emptyboolean