Discover the ONE Record server endpoint for the baggage carrier; ONE Record uses a linked-data model where each server is self-hosted by the stakeholder (airline, handler) — obtain the base URL from the carrier's ONE Record endpoint registry.
Authenticate via OAuth 2.0 or the security mechanism required by the server (ONE Record 2.2.0 defers specific auth to the implementation); include the Bearer token in the Authorization header.
Create or retrieve the Piece logistics object via POST /logistics-objects (if you are the data owner) or GET /logistics-objects/{logisticsObjectId} if the airline owns the piece record — the ID is a URI.
Subscribe to change notifications for the Piece object: POST /notifications with a subscription payload specifying the logistics object URI and your callback endpoint; the server will POST change events to your callback as the baggage progresses.
On receiving a notification, fetch the updated Piece object; inspect the LogisticsEvents array for milestone events such as BKD (booked), RCS (received from shipper), DEP (departed), ARR (arrived), DLV (delivered to passenger), or TRM (transferred to another carrier).
Map ONE Record milestone codes to human-readable baggage status messages for passenger-facing display; handle missing or delayed events by falling back to the flight status board for the relevant segment.
Known gotchas
ONE Record is primarily a cargo standard; airline use for passenger baggage tracking is emerging and not yet uniformly implemented — availability varies by carrier; some airlines only expose ONE Record for cargo, not checked baggage.
The ONE Record API version 2.2.0 was endorsed in July 2025 — implementations may still be running earlier versions (1.2 or 2.0); check the server's /about endpoint for the supported version before assuming data model compatibility.
Logistics object URIs are opaque and server-scoped; never construct them by pattern — always retrieve them from a canonical data source or the airline's booking response.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp