Vessels

Every tracked shipment includes the vessel on the current voyage: name, IMO number, and voyage number. That identity comes from the ocean carrier and is available as soon as the carrier publishes the voyage. AIS position and projected route are available through the Vessels API with the Routing Data / vessel positions entitlement — a separate account enablement, not included in every paid plan. Without it, the position endpoints return 403 Forbidden. See entitlements.

​

What you get

​

How to look up a vessel

• GET /vessels/{id} — Terminal49 vessel ID from a shipment or event
• GET /vessels/{imo} — when you already have the IMO number
• GET /vessels/{id}/future_positions — estimated positions between ports, one minute apart

Use the map and routing guides when you want to plot the voyage.

​

What vessel data is not

AIS coverage is not a substitute for carrier milestones. A position update does not mean the container is loaded, discharged, or available. Treat AIS as the vessel’s location; treat ocean, terminal, and rail events as the container’s status.