Public API — Release Notes

Changes to the Retraced Public API: new endpoints and fields, behavior changes, fixes, and deprecations. Platform releases that do not affect the public API are not listed here.

See also the API Reference and the integration guides.

v2.1075.0 — 2026-09-09

• FixedCertificate list fileUrl is a signed download URL, matching get-by-id

v2.1044.0 — 2026-08-28

• ChangedSimplify environment guidance in Getting Started

v2.1027.0 — 2026-08-25

• AddedAttachment template now can be pre-selected on order level (order hub)

v2.986.5 — 2026-08-07

• FixedBOM validation now accepts dynamic units defined from style-type
• FixedMutation and single-resource endpoints no longer document a pagination block

v2.986.0 — 2026-08-06

• AddedFetching a single order line now embeds its parent order
• FixedAttachment templates now paginate like every other list endpoint
• FixedThe receiver company and its facility process must always be sent together on orders
• ChangedImprove integration guides and examples

v2.982.0 — 2026-08-05

• FixedGet supplychain to return supply chain info no check style product story active flag

v2.976.0 — 2026-08-04

• AddedAllow using your own id instead of retraced generated id

v2.974.0 — 2026-08-03

• AddedAdd rate limit all public api

v2.965.0 — 2026-07-30

• FixedSecondary unit is always derived from secondary quantity on order lines

v2.961.0 — 2026-07-29

• AddedAdd handoverDate and deprecate expectedDeliveryDate
• FixedStable ordering and pagination for orders and order lines

v2.957.0 — 2026-07-28

• AddedStandardise every list endpoint on a page size of 20 with a maximum of 100
• FixedOrder writes now reject unknown facility process IDs

v2.955.0 — 2026-07-27

• AddedAdd facility process and production process reference endpoints
• AddedImprove navbar document pages

v2.954.0 — 2026-07-27

• AddedAdd field and parameter descriptions across the API reference

v2.953.0 — 2026-07-27

• AddedAdd a Getting Started guide and expand the integration guides

v2.947.0 — 2026-07-23

• AddedArchived products can no longer be used when creating an order
• AddedCompanies referenced on an order no longer need to be in your network
• AddedCreating an order now requires the caller to be the order's buyer or supplier
• AddedDeleting an order now also removes its linked order-tracing data
• AddedOrder responses now include receiverCompanyId and orderType
• AddedOrders now support multiple responsible users via internalResponsiblePersons
• AddedSetting a receiver on create now requires both receiverCompanyId and receiverFacilityProcess
• AddedThe receiver now defaults to the buyer when omitted on order creation

v2.930.2 — 2026-07-14

• FixedUpdate response example and schema for supply chain tier
• ChangedAdd release note and start gathering information for public api