--- 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` ## Request - Base URL: `https://api.prewave.com` - URL: `https://api.prewave.com/public/v1/target/{systemId}/{targetId}/alerts` - Auth: API key in header `X-Auth-Token` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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, nullable: Deprecated. Unused leftover sort rank. Omitted when enabled for your organization. - `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: Deprecated. Date of the earliest alert. Omitted when enabled for your organization. - `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': Impact level. - `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 - `url` string, nullable - `title` string, nullable - `description` 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, nullable: Deprecated. Unused leftover sort rank. Omitted when enabled for your organization. - `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: Deprecated. Date of the earliest alert. Omitted when enabled for your organization. - `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': Impact level. - `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. ## Changes - **2026-10-17** `cedf01f35c95`: 4 info - added `#/components/schemas/PublicLevel` to the `content/items/locations/items/impact` response property `allOf` list for the response status `200` - added `#/components/schemas/PublicLevel` to the `content/items/primaryTargets/items/target/impact` response property `allOf` list for the response status `200` - removed `#/components/schemas/Level` from the `content/items/locations/items/impact` response property `allOf` list for the response status `200` - removed `#/components/schemas/Level` from the `content/items/primaryTargets/items/target/impact` response property `allOf` list for the response status `200` - **2026-09-25** `03c1c9d14a3b`: 5 warning - removed the optional property `content/items/links/items/id` from the response with the `200` status - removed the optional property `content/items/links/items/originalDescription` from the response with the `200` status - removed the optional property `content/items/links/items/originalLang` from the response with the `200` status - removed the optional property `content/items/links/items/originalTitle` from the response with the `200` status - …1 more - **2026-09-01** `0ab68d9081f9`: 2 info - response property `content/items/locations/items/earliestAlert` deprecated - response property `content/items/primaryTargets/items/target/earliestAlert` deprecated - …earlier changes not shown [Operation history](https://skmtc.dev/prewave/apis/public-prewave-api/changes/public/v1/target/:systemId/:targetId/alerts/get.md) --- [API](https://skmtc.dev/prewave/apis/public-prewave-api.md) - [All operations](https://skmtc.dev/prewave/apis/public-prewave-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prewave/apis/public-prewave-api/revisions/8b6e3b3827ca?raw)