Implement the DCSA Track and Trace v2.2 standard to build a carrier-agnostic ocean container tracking client

domain: dcsa.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Download the DCSA Track and Trace v2.2 OpenAPI specification from the DCSA GitHub repository at github.com/dcsaorg/DCSA-OpenAPI; review the Event Structure Definitions and DCSA Industry Blueprint 3.0.
  2. Identify the three primary event categories: Transport Events (vessel departure/arrival), Equipment Events (gate-in/out, load/discharge), and Shipment Events (booking confirmed, B/L issued).
  3. For each carrier integration, obtain API credentials from the carrier developer portal (Maersk, Hapag-Lloyd, etc.) and confirm which DCSA T&T version they implement; map any carrier-specific event codes to DCSA equivalents.
  4. Build a normalised event ingestion layer that maps carrier API responses to the DCSA event schema; store eventType, eventDateTime, eventClassifierCode, and location fields in a canonical format.
  5. Implement the DCSA Subscription Callback API v1.0 on your server to receive push notifications from carriers that support server-to-server push; fall back to polling for carriers that do not.
  6. Validate your implementation against the DCSA conformance test suite available on GitHub before going live with each carrier integration.

Known gotchas

Related routes

Implement container tracking across ocean carrier, terminal, and rail legs using the DCSA Track and Trace v2.2 TransportEvent subscription model
dcsa.org · 6 steps · unrated
Generate a DCSA-compliant Track and Trace v2.2 TransportEvent payload and implement the event subscription webhook for multi-carrier ocean tracking
dcsa.org · 5 steps · unrated
Track ocean container milestones and exception events using a carrier or third-party visibility API
logistics-general · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans