Get real time and estimated data on shipment locations and status. Track any shipment by CT, BL or BK.
Track any container using CT, BL or BK number.
Get data from over 170 global shipping lines in one single endpoint.
Retrieve list of locations, dates and events associated with each container journey.
Frequent use-cases served:
- Get shipment ETA at POD (shipping line data) + Predictive ETA at POD
- Get shipment current gps position + key locations : PREPOL, POL, POD, POSTPOD
- Get event updates associated to key locations and transhipments
- Get route segment data
- Get vessel details
Response map
metadata
object - additional data on the api request
metadata
object - additional data on the api requestshipmentType
string - can be CT
BL
BK
if this parameter is not present in the request, it will be autodetected.
shipmentNumber
string - shipment reference entered as input.
sealine
string - shipping line SCAC code. If this parameter is not present in the request, it will be autodetected.
sealineName
string - name of the shipping line in full.
shippingStatus
string - can be PLANNED
IN_TRANSIT
or DELIVERED
If no event dates are available, status is PLANNED
, if event dates are still in the future status is IN_TRANSIT
and if all dates are in the past and delivery has been confirmed by sealine, status is DELIVERED
.
updatedAt
string - timestamp from when data was last received from the carrier.
warnings
string - warnings on data quality or discrepancies in data received from carrier. Warnings can be
MISSING_DATES
at least one of the event dates is nullOBSOLETE_DATA
timestamp fromupdatedAt
is older than 24 hoursNO_POL
no Port of Loading received from carrierNO_POD
no Port of Discharge received from carrierSTATUS_MISMATCH
shipment status is in conflict with event dates
locations
object - array of locations
locations
object - array of locationsname
string - location name
state
string - location state
country
string - country of location
countryCode
string - country code of the location (2 characters)
locode
string - UN/LOCODE of the port
coordinates
- latitude and longitude of the location
timezone
string - timezone of the location. Dates are displayed in local time.
route
object - route details from PREPOL to POSTPOD
route
object - route details from PREPOL to POSTPODprepol
object - place of dispatch
prepol
object - place of dispatchdate
string - date of first event at first location
isActual
boolean - if true, the date is actual if false, the date is estimated
pol
object - port of loading
pol
object - port of loadingdate
string - date of the first event received by the carrier in the first port of loading
isActual
boolean - if true, the date is actual, if false, the date is estimated.
pod
object - port of discharge
pod
object - port of dischargedate
string - date of the first event received by the carrier in the first port of discharge - usually date of arrival
isActual
boolean - if true, the date is actual, if false, the date is estimated.
predictiveEta
string - available when the shipment is within 3 days of its arrival at POD. Sinay calculation based on historical AIS data, live port congestion and wheather.
postpod
object - destination
postpod
object - destinationdate
string - date of the first event received in the last destination / location
isActual
boolean - if true, the date is actual if false, the date is estimated
vessels
object - array of vessels transporting containers
vessels
object - array of vessels transporting containersname
string - vessel name
imo
string - unique identifier of the vessel
callSign
strop - call sign of the vessel
mmsi
integer - maritime mobile service identity
flag
string - country code (2 characters)
containers
object - container data
containers
object - container datanumber
string - container number or unknown
if the carrier provides incorrect or no data
isoCode
string - ISO code of the container
status
string - can be PLANNED
, IN_TRANSIT
or DELIVERED
events object - events and associated dates
location string - and associated details
facility string - if available and provided by the carrier
description string - event description
eventType string - type of event. Can be SHIPMENT
TRANSPORT
or EQUIPMENT
eventCode string - event code. Can be:
TRANSPORT
ARRI
- arrivedDEPA
- departed
EQUIPMENT
LOAD
- loadedDISC
- dischargedGTIN
- gated inGTOT
- gated outSTUF
- stuffedSTRP
- strippedPICK
- pick-upAVPU
- available for pick-upDROP
- drop-offAVDO
- available for drop offINSP
- inspectedRSEA
- resealedRMVD
- removedCUSS
- customs selected for scanCUSI
- customs selected for inspectionCUSR
- customs releasedCROS
- crossed
SHIPMENT
RECE
- receivedDRFT
- draftedPENA
- pending updatePENU
- pending confirmationPENC
- pending confirmationCONF
- confirmedREJE
- rejectedAPPR
- approvedISSU
- issuedSURR
- surrenderedSUBM
- submittedVOID
- voifREQS
- requestedCMPL
- completedHOLD
- on holdRELS
- releasedCANC
- cancelled
status
string - 3 character event code. Can be :
CEP
- container empty to shipperCPS
- container pickup at shipperCGI
- container arrival at first POL (gate in)CLL
- container loaded at first POLVDL
- vessel departure from first POLVAT
- vessel arrival at transhipment portCDT
- vessel departure from transhipment portTSD
- transhipment delayCLT
- container loaded at transhipment portVDT
- vessel departure from transhipment portVAD
- vessel arrival at final PODCDD
- container discharge at final PODCGO
- container departure from final POD ( gate out)CDC
- container delivery to consigneeCER
- container empty return to depotLTS
- land transhipmentBTS
- barge transhipmentUNK
- unknown
date
string - event date
isActual
boolean - if true, the date is actual, if false the date is estimated
routeType
string - type of transport. Can be SEA
or LAND
.
voyage
string - sea voyage identifier
routeData
object - route coordinates. Available if set to true in the request.
routeData
object - route coordinates. Available if set to true in the request.route object
array of route segments from first to last location.
coordinates
Current position of the vessel transporting the shipment. Location from AIS. Latitude and longitude.
AIS
object - available if set to true in the request.
AIS
object - available if set to true in the request.status
string - can be OK
NOT_ON_BOARD
NO_AIS_DATA
status
string - can be OK
NOT_ON_BOARD
NO_AIS_DATA
lastEvent
object - latest event provided by shipping line
lastEvent
object - latest event provided by shipping linedescription string - event description
dischargePort
object - date of the final port of discharge
dischargePort
object - date of the final port of discharge