466169815b78
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
Path parameters
An identifier that indicates which system the targetId originates from. Supported values are "prewave", "customer", "supplier", "own".
The target ID can be the target's prewaveId or an external id (edge number) representing the site in another system.
Query parameters
Only return alerts that are newer than the given timestamp (Timestamp in milliseconds since epoch)
List of priorities to filter the feed by
If set to true, the response will include the geo information.
The perspective ID to filter the alerts. If not provided, the user's perspective ID will be used.
Response
Successfully retrieved target alerts