--- title: "Get alerts for a specific target" method: GET path: "/public/v1/target/{systemId}/{targetId}/alerts" tags: ["Alerts"] --- # Get alerts for a specific target `GET /public/v1/target/{systemId}/{targetId}/alerts` 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 - `systemId` string, required - `targetId` string, required ## Query parameters - `newerThan` integer - `priorities` Priority[] - `includeGeo` boolean - `perspectiveId` integer - `pageable` Pageable, required - `page` integer - `size` integer - `sort` string[] ## Response `200` Successfully retrieved target alerts - object - `content` PublicAlertDTO[] - `id` integer, required — Prewave-internal alert id - `uuid` string, uuid, required — Prewave-internal alert uuid - `title` string, nullable — Alert title - `createdAt` string, date-time, required — When the alert was generated/created at prewave - `predictedAtStart` string, date-time, nullable — When the event - that this alert is describing - started - `predictedAtEnd` string, date-time, nullable — When the event - that this alert is describing - ended - `description` string, nullable — Detailed description of alert. Usually an excerpt taken from one of the links - `event` PublicEventDTO, required — Way of grouping alerts that belong to the same event, e.g. Strike announcement, Strike happens, Strike terminates - `uuid` string, uuid, required — Prewave event uuid - `locations` PublicTargetDTO[], required — Locations where the alert happened - `id` integer, required — Prewave target id - `name` string, required — Name of the Prewave target - `sname` string, nullable — Geonames Id (see https://geonames.org) - `logo` string, nullable — URL to the logo shown in the target profile - `backgroundPicture` string, nullable — URL to the background picture shown in the target profile - `description` string, nullable — Description of the Prewave target - `website` string, nullable — URL to the website shown in the target profile - `location` string, nullable — Location of the target - `yearFounded` integer, nullable — Year the target was founded shown in the target profile - `size` 'Small' | 'Medium' | 'Large' | 'Very large' - `screened` boolean, required — Whether the target is screened or not - `screenedStatus` 'Required' | 'Pending' | 'Screened' | 'NotPossible' — Screening status of the target - `linkedInId` string, nullable — LinkedIn ID of the target - `type` PublicTargetTypeDTO, required — Target types are what is known as "Target Type" in the Prewave system (e.g in Network > Filters). They provide a broad categorization of what the target is. Examples for target types are "poi", "organization" etc. - `id` integer, required — Prewave-internal ID of the target type - `type` string, required — Machine-readable name of the target type - `displayName` string, required — Display name of the target type - `pluralName` string, required — Plural name of the target type - `ordering` integer, nullable — Ordering of the target type - `scoring` 'Alert' | 'Peer' — Scoring of the target type - `ctype` PublicTargetCTypeDTO, required — CTypes are what is known as "Facility Types" in the Prewave system (e.g in Network > Filters). They provide a slightly more specific categorization of what the target is. Examples for ctypes are "mine", "factory" etc. - `id` integer, required — Prewave-internal id of the target ctype - `ctype` string, required — Name of the target ctype - `targetTypeId` integer, required — Identifier of the target ctype - `displayName` string, required — Display name of the target ctype - `pluralName` string, required — Plural name of the target ctype - `icon` string, required — Icon of the target ctype. Fontawesome icon name. See https://fontawesome.com/icons for more information - `ordering` integer, nullable — Ordering of the target ctype - `priority` integer, required — Priority of the target ctype - `connectable` boolean, required — Whether it is possible to connect to targets of this type or not - `bgColor` string, required — Background color of the target ctype. Valid CSS color value - `textColor` string, required — Text color of the target ctype. Valid CSS color value - `geo` Geo, required — Geo information for this alert. Only available if includeGeo is set to true. - `geometry` Geometry — GeoJSON-compatible geometry object. Fields follow the GeoJSON spec (https://geojson.org): a `type` string (e.g. `Point`, `Polygon`) and a `coordinates` array. - `properties` GeoProperties, required - `name` string, nullable - `countryCode` string, nullable - `alertCount` integer, nullable - `boundingBox` BoundingBox - `xmin` number, double, required - `ymin` number, double, required - `xmax` number, double, required - `ymax` number, double, required - `type` string, required - `geoShape` Geo, required — Geo information for this alert. Only available if includeGeo is set to true. - `geometry` Geometry — GeoJSON-compatible geometry object. Fields follow the GeoJSON spec (https://geojson.org): a `type` string (e.g. `Point`, `Polygon`) and a `coordinates` array. - `properties` GeoProperties, required - `name` string, nullable - `countryCode` string, nullable - `alertCount` integer, nullable - `boundingBox` BoundingBox - `xmin` number, double, required - `ymin` number, double, required - `xmax` number, double, required - `ymax` number, double, required - `type` string, required - `parents` PublicTargetDTO[], required — List of parent targets - `organization` PublicTargetDTO — recursive - `industries` PublicTargetDTO[], required — List of industries the target belongs to - `monitoredSince` string, date-time, nullable — Date the target was monitored since - `earliestAlert` string, date-time, nullable — Date of the earliest alert - `ordering` integer, nullable — Ordering of the target - `disruptionStatusUpdate` object, nullable — Deprecated. Disruption status has been removed and this field is always null. - `own` boolean, required — Whether the target is owned by user customer or not - `managed` boolean, required — `true` if user is target connection contact or target is owned by user customer, `false` otherwise - `isPublic` boolean, nullable — Whether the target is public or not - `connectionContactsCount` integer, nullable — Number of connection contacts of the target - `population` integer, nullable — Population of the target. Generally applies to locations - `following` boolean, required — Target resides in "My follows" collection - `collectionFollowing` boolean, required — Target resides in any followed collection (including children) - `tier` integer, nullable — Tier of the target (relevant when fetching Tier-N) - `path` PublicTargetRefExtended[], required — Path of the target (relevant when fetching Tier-N) - `id` integer, required - `name` string, required - `customName` string, nullable - `latestRequest` TargetRequestInfoDto - `targetId` integer, required - `validationRequest` TargetRequestTypeStatusDto - `id` integer, nullable - `customerId` integer, nullable - `status` 'NONE' | 'PENDING' | 'COMPLETED' | 'REJECTED' - `rejectionReason` string, nullable - `screeningRequest` TargetRequestTypeStatusDto - `id` integer, nullable - `customerId` integer, nullable - `status` 'NONE' | 'PENDING' | 'COMPLETED' | 'REJECTED' - `rejectionReason` string, nullable - `reportedTargetRequest` TargetRequestTypeStatusDto - `id` integer, nullable - `customerId` integer, nullable - `status` 'NONE' | 'PENDING' | 'COMPLETED' | 'REJECTED' - `rejectionReason` string, nullable - `foreignSystems` EdgeNumber[], required - `number` string, required - `source` string, nullable - `existingEdgeId` integer, nullable - `collectionLevel` integer, nullable — How deep the target is in the collection hierarchy - `collectionPath` CollectionRef[], required — Path of the target in the collection hierarchy - `id` integer, required - `name` string, required - `collectionPaths` array[], required — Paths of the target in the collection hierarchy - CollectionRef[] — Paths of the target in the collection hierarchy - `id` integer, required - `name` string, required - `foreignSystems` PublicTargetForeignSystemDTO[], required — List of foreign systems the target is connected to - `system` string, required — The system ID is an identifier to determine from which the targetId might originate from. Supported systemIds are "prewave", "customer", "supplier", "own". - `id` string, required — The id in the foreign system - `source` string, nullable — Name of the foreign system - `scoreAvail` 'None' | 'Peer' | 'Alert' | 'SSA' | 'External', required - `revenue` number, nullable — Revenue of the target - `impact` 'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical' - `hsCode` PublicHSCode[], required — List of HS Codes of the target - `code` string, required - `nShipments` integer, nullable - `nshipments` integer - `mergedTargets` integer[], required — Target ids of past targets that were merged into this current target - `public` boolean - `links` PublicLinkDTO[], required — Source links the alert is based on - `id` integer, nullable - `url` string, nullable - `title` string, nullable - `description` string, nullable - `pictureUrl` string, nullable - `originalLang` string, nullable - `originalTitle` string, nullable - `originalDescription` string, nullable - `media` PublicMediaDTO[], required — Media files attached to the alert - `id` integer, nullable - `url` string, nullable - `mimeType` string, nullable - `infotags` PublicInfotagDTO[], required - `id` integer, required - `type` PublicInfotagTypeDTO, required - `type` string, required - `active` boolean, required - `displayName` string, nullable - `icon` string, nullable - `ordering` integer, nullable - `display` boolean, required - `value` string, required - `svalue` string, nullable - `icon` string, nullable - `numValue` number, nullable - `priority` 'Low' | 'Mid' | 'High' | 'Critical' — Priority of alert - `impactScore` 'Low' | 'Mid' | 'High' | 'Critical' — Priority of alert - `primaryTargets` PublicAlertTargetDTO[], required — The targets affected by this alert. - `target` PublicTargetDTO, required - `id` integer, required — Prewave target id - `name` string, required — Name of the Prewave target - `sname` string, nullable — Geonames Id (see https://geonames.org) - `logo` string, nullable — URL to the logo shown in the target profile - `backgroundPicture` string, nullable — URL to the background picture shown in the target profile - `description` string, nullable — Description of the Prewave target - `website` string, nullable — URL to the website shown in the target profile - `location` string, nullable — Location of the target - `yearFounded` integer, nullable — Year the target was founded shown in the target profile - `size` 'Small' | 'Medium' | 'Large' | 'Very large' - `screened` boolean, required — Whether the target is screened or not - `screenedStatus` 'Required' | 'Pending' | 'Screened' | 'NotPossible' — Screening status of the target - `linkedInId` string, nullable — LinkedIn ID of the target - `type` PublicTargetTypeDTO, required — Target types are what is known as "Target Type" in the Prewave system (e.g in Network > Filters). They provide a broad categorization of what the target is. Examples for target types are "poi", "organization" etc. - `id` integer, required — Prewave-internal ID of the target type - `type` string, required — Machine-readable name of the target type - `displayName` string, required — Display name of the target type - `pluralName` string, required — Plural name of the target type - `ordering` integer, nullable — Ordering of the target type - `scoring` 'Alert' | 'Peer' — Scoring of the target type - `ctype` PublicTargetCTypeDTO, required — CTypes are what is known as "Facility Types" in the Prewave system (e.g in Network > Filters). They provide a slightly more specific categorization of what the target is. Examples for ctypes are "mine", "factory" etc. - `id` integer, required — Prewave-internal id of the target ctype - `ctype` string, required — Name of the target ctype - `targetTypeId` integer, required — Identifier of the target ctype - `displayName` string, required — Display name of the target ctype - `pluralName` string, required — Plural name of the target ctype - `icon` string, required — Icon of the target ctype. Fontawesome icon name. See https://fontawesome.com/icons for more information - `ordering` integer, nullable — Ordering of the target ctype - `priority` integer, required — Priority of the target ctype - `connectable` boolean, required — Whether it is possible to connect to targets of this type or not - `bgColor` string, required — Background color of the target ctype. Valid CSS color value - `textColor` string, required — Text color of the target ctype. Valid CSS color value - `geo` Geo, required — Geo information for this alert. Only available if includeGeo is set to true. - `geometry` Geometry — GeoJSON-compatible geometry object. Fields follow the GeoJSON spec (https://geojson.org): a `type` string (e.g. `Point`, `Polygon`) and a `coordinates` array. - `properties` GeoProperties, required - `name` string, nullable - `countryCode` string, nullable - `alertCount` integer, nullable - `boundingBox` BoundingBox - … - `type` string, required - `geoShape` Geo, required — Geo information for this alert. Only available if includeGeo is set to true. - `geometry` Geometry — GeoJSON-compatible geometry object. Fields follow the GeoJSON spec (https://geojson.org): a `type` string (e.g. `Point`, `Polygon`) and a `coordinates` array. - `properties` GeoProperties, required - `name` string, nullable - `countryCode` string, nullable - `alertCount` integer, nullable - `boundingBox` BoundingBox - … - `type` string, required - `parents` PublicTargetDTO[], required — List of parent targets - `organization` PublicTargetDTO — recursive - `industries` PublicTargetDTO[], required — List of industries the target belongs to - `monitoredSince` string, date-time, nullable — Date the target was monitored since - `earliestAlert` string, date-time, nullable — Date of the earliest alert - `ordering` integer, nullable — Ordering of the target - `disruptionStatusUpdate` object, nullable — Deprecated. Disruption status has been removed and this field is always null. - `own` boolean, required — Whether the target is owned by user customer or not - `managed` boolean, required — `true` if user is target connection contact or target is owned by user customer, `false` otherwise - `isPublic` boolean, nullable — Whether the target is public or not - `connectionContactsCount` integer, nullable — Number of connection contacts of the target - `population` integer, nullable — Population of the target. Generally applies to locations - `following` boolean, required — Target resides in "My follows" collection - `collectionFollowing` boolean, required — Target resides in any followed collection (including children) - `tier` integer, nullable — Tier of the target (relevant when fetching Tier-N) - `path` PublicTargetRefExtended[], required — Path of the target (relevant when fetching Tier-N) - `id` integer, required - `name` string, required - `customName` string, nullable - `latestRequest` TargetRequestInfoDto - `targetId` integer, required - `validationRequest` TargetRequestTypeStatusDto - … - `screeningRequest` TargetRequestTypeStatusDto - … - `reportedTargetRequest` TargetRequestTypeStatusDto - … - `foreignSystems` EdgeNumber[], required - `number` string, required - `source` string, nullable - `existingEdgeId` integer, nullable - `collectionLevel` integer, nullable — How deep the target is in the collection hierarchy - `collectionPath` CollectionRef[], required — Path of the target in the collection hierarchy - `id` integer, required - `name` string, required - `collectionPaths` array[], required — Paths of the target in the collection hierarchy - CollectionRef[] — Paths of the target in the collection hierarchy - `id` integer, required - `name` string, required - `foreignSystems` PublicTargetForeignSystemDTO[], required — List of foreign systems the target is connected to - `system` string, required — The system ID is an identifier to determine from which the targetId might originate from. Supported systemIds are "prewave", "customer", "supplier", "own". - `id` string, required — The id in the foreign system - `source` string, nullable — Name of the foreign system - `scoreAvail` 'None' | 'Peer' | 'Alert' | 'SSA' | 'External', required - `revenue` number, nullable — Revenue of the target - `impact` 'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical' - `hsCode` PublicHSCode[], required — List of HS Codes of the target - `code` string, required - `nShipments` integer, nullable - `nshipments` integer - `mergedTargets` integer[], required — Target ids of past targets that were merged into this current target - `public` boolean - `impactLevel` PublicImpactLevelDTO, required - `id` integer, required - `level` 'company_poi_to_eoi' | 'direct' | 'related_target' | 'company' | 'industry' | 'regional' | 'tier2' | 'tier3plus' | 'in-company' | 'commodity' | 'country' | 'mention', required - `displayName` string, required - `ordering` integer, required - `impactScore` 'Low' | 'Mid' | 'High' | 'Critical' — Priority of alert - `priority` 'Low' | 'Mid' | 'High' | 'Critical' — Priority of alert - `priority` 'Low' | 'Mid' | 'High' | 'Critical' — Priority of alert - `priorityDetails` PublicPriorityDetailsDTO — Priority details of alert - `massDisruption` boolean, required - `brandMention` boolean, required - `rumour` boolean, required - `lowPeerRisk` boolean, required - `terminates` boolean, required - `collectionPath` PublicCollectionPathRef[], required — The collections and their hierarchy for the target - `id` integer, required - `name` string, required - `path` CollectionRef[], required - `id` integer, required - `name` string, required - `geo` Geo — Geo information for this alert. Only available if includeGeo is set to true. - `geometry` Geometry — GeoJSON-compatible geometry object. Fields follow the GeoJSON spec (https://geojson.org): a `type` string (e.g. `Point`, `Polygon`) and a `coordinates` array. - `properties` GeoProperties, required - `name` string, nullable - `countryCode` string, nullable - `alertCount` integer, nullable - `boundingBox` BoundingBox - `xmin` number, double, required - `ymin` number, double, required - `xmax` number, double, required - `ymax` number, double, required - `type` string, required - `size` integer - `number` integer - `totalElements` integer - `totalPages` integer - `numberOfElements` integer - `first` boolean - `last` boolean - `empty` boolean ## Other responses - `400` — Bad Request - Invalid parameters (e.g., invalid timestamp, invalid priority values) - `403` — 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource. - `404` — Target not found or foreign system ID mapping not found - `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success. - `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed. --- [API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)