Skip to main content

2026.03: Public API Updates

Public API Changelog โ€” March 2026

This document contains the changelog and release notes for the Prewave Public API for March 2026. This monthโ€™s update is headlined by the upcoming launch of the Feed API v2, designed to provide more structured alert data with enhanced performance.


๐Ÿ“ก Feed API v2

Endpoint: GET /public/v2/feed

The new Feed API delivers the same alert data as the dashboard feed but with a cleaner contract and better throughput.

๐ŸŽฏ Key Benefits

  • Tier Control: New minTier and maxTier parameters allow you to scope alerts to specific supply chain levels (e.g., Tiers 1โ€“3).

  • Standardized Dates: Uses UTC ISO 8601 format for the from parameter.

  • Structured Metadata: Replaces the flat infotags list with structured fields like eventTypes, eventTypeGroups, and alertTypes.

  • Automatic Lookback: If the date is omitted, the API now defaults to returning the last 90 days of data.

  • Response Timestamps: All response timestamps (e.g., createdAt) are now returned as ISO 8601 strings rather than numeric milliseconds.


๐Ÿ”„ Migration Guide: V1 to V2

Existing integrations should note the following changes when moving to the V2 endpoint:

Aspect

V1 (/public/v1/feed)

V2 (/public/v2/feed)

Collections

collectionId (singular)

collectionIds (plural)

Date filter

from or newerThan (ms)

from only (ISO 8601)

Response Format

Numeric timestamps

ISO 8601 strings

[!NOTE]

Feed v1 remains supported, but we recommend all new integrations use Feed v2 starting 19 March 2026.


๐Ÿ”ฎ Planned Roadmap

The following features are currently in development:

  • ๐Ÿ“Š External Score Ingestion API: Push external scores to Prewave in an auditable way.

  • ๐Ÿ” Supplier Screening (V2): Request history screening and check status via Supplier Site V2 endpoints.

  • โœ… Supplier Validation (V2): Improved flow for requesting supplier discovery and validation.

  • ๐Ÿ“‚ Enhanced Supplier Lookup: Find-by-identifier responses will be expanded to include industries, collections, and connections in a single call.


โš ๏ธ Deprecations & Removals

  • Deprecations: No new deprecations this month. The sunset date for legacy supplier and sites-upsert endpoints remains December 31, 2026.

  • Removals: No endpoints were removed in March 2026.


๐Ÿ’ฌ Support

For questions regarding the Feed v2 migration or the upcoming roadmap:

Did this answer your question?