Skip to main content

Introduction to Our Data Models

To make sense of the information our API provides, it helps to understand the main building blocks we use to represent shipment visibility. These data models are the foundation of how we organize tracking information.

Shipping Line​

Represents an ocean carrier. Each shipping line has a name and a SCAC code, which helps ensure faster and more accurate tracking. Some shipping lines support certain tracking types (container, bill of lading, booking) while others may not.

See supported shipping lines

Shipment​

A shipment brings together everything you need to know about a tracked movement: the tracking details, related documents, conversations, and more. Think of it as the central hub for a customer’s cargo journey. Each shipment can have a container, a bill of lading, or a booking.

Container Tracking​

Captures the journey of an individual container. It includes origin, destination, arrival and departure dates, transshipment ports, vessel details, terminal events, and standardized movement milestones.

Bill of Lading (BL) Tracking​

Centers around a bill of lading and may include multiple containers. It gives visibility into everything covered by that BL.

Booking Tracking​

Focuses on a booking reference, which may relate to multiple containers or bills of lading. It gives an overview at the booking level.

Location​

Represents ports and facilities with details such as country, UN/LOCODE, and facility names. Locations make tracking events more meaningful by tying them to real-world places.

Position​

Captures a geographic point using latitude and longitude. For example, it can show where a container or vessel was at a specific time.

Movements​

Movements are the standardized events that describe a container’s journey. Each includes:

  • Event code and description (aligned with DCSA where possible)
  • Timestamp
  • Location and facility type
  • Mode of transport (vessel, rail, truck)
  • Vessel name and voyage

See supported movements

Terminal​

Provides data about container status at a port or terminal. This includes details such as:

  • Last free day
  • Pickup availability and date
  • Holds and fees

See terminal coverage

Rail​

Covers intermodal rail tracking across North American carriers (CN, CPKC, UP, BNSF, CSX). Information includes:

  • Origin and destination locations
  • Departure and arrival times
  • Current status and last location
  • Customs holds and pickup availability
  • Waybill status

These models work together to create a complete picture of your shipment’s journey—from booking to vessel movements, terminal status, and rail connections.

Last updated on