A quick guide to understand Container Tracking basics and best practices and get started in just a few steps.
Container Tracking Overview
- Authentication & Headers
- Shipping Line Coverage
- GET/shipment endpoint : response breakdown
- API Best Practices
- Troubleshooting common errors
- Useful Links to quick guides: How to get an ETA, How to Retrieve Location, How to Set Up Webhooks
Authentication & Headers
The Container tracking API uses the same API Framework as all the other Sinay APIs. Authorization is completed with an API key in the API request header.
- Get an API key
You can get an API key by creating an account for free or by subscribing to one of our paid plans.
- Authenticate in the API
Add the API key in the request header
Shipping Line Coverage
The Container Tracking API covers data from over 170 global carriers.
You can retrieve this information directly from the api, using GET/sealines.
{
"sealines": [
{
"name": "AC Container Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ALRB"
],
"prefixes": []
},
{
"name": "Admiral Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ADMU"
],
"prefixes": [
"BLS",
"ADM"
]
},
{
"name": "Akkon Lines",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"AKKU"
],
"prefixes": [
"AKK"
]
},
{
"name": "Aladin Express",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ALXP"
],
"prefixes": []
},
{
"name": "Alianca",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"ANRM"
],
"prefixes": []
},
{
"name": "Allalouf Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ALLF"
],
"prefixes": []
},
{
"name": "Altun Logistics",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"ALKU"
],
"prefixes": [
"ALK",
"NKT"
]
},
{
"name": "AMASS",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"AMIG"
],
"prefixes": []
},
{
"name": "American President Lines (APL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"APLU"
],
"prefixes": [
"APD",
"APH",
"API",
"APL",
"APR",
"APZ"
]
},
{
"name": "Arkas",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ARKU"
],
"prefixes": [
"ARK"
]
},
{
"name": "Asyad Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ASLU"
],
"prefixes": []
},
{
"name": "Atlantic Container Line (ACL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ACLU"
],
"prefixes": [
"ACL"
]
},
{
"name": "Australia National Line (ANL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ANNU"
],
"prefixes": []
},
{
"name": "Avana Global FZCO (BALAJI)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BLJU"
],
"prefixes": [
"BLJ",
"AVN",
"SSM"
]
},
{
"name": "BAL Container Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BURU"
],
"prefixes": [
"BUR"
]
},
{
"name": "Bee Logistics",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BELC"
],
"prefixes": []
},
{
"name": "BLPL Singapore",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"BLZU"
],
"prefixes": [
"BLZ"
]
},
{
"name": "Blue Anchor America Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BANQ"
],
"prefixes": []
},
{
"name": "Blue Water Lines (BWL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"BWLU"
],
"prefixes": [
"BWL"
]
},
{
"name": "Blue World Line",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BWLE"
],
"prefixes": []
},
{
"name": "BMC Line Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BMSU"
],
"prefixes": []
},
{
"name": "BNSF Logistics",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BNLS"
],
"prefixes": []
},
{
"name": "Camellia Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": false
},
"maintenance": false,
"scacCodes": [
"CAKU"
],
"prefixes": []
},
{
"name": "Cargo-Partner",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"CPNU"
],
"prefixes": [
"CPO"
]
},
{
"name": "Carpenters Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MBFU"
],
"prefixes": [
"MBF"
]
},
{
"name": "China United Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CULU"
],
"prefixes": [
"CUL"
]
},
{
"name": "CK Line",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CKLU"
],
"prefixes": [
"CKL"
]
},
{
"name": "CMA CGM",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CMDU"
],
"prefixes": [
"STM",
"OPD",
"OTA",
"MMC",
"CMA",
"CMN",
"CNC",
"ECM",
"CGH",
"CGM",
"CGT",
"DVR",
"ANN",
"AMC",
"NOL",
"NOS",
"NUS",
"NEP",
"SOF",
"CSF",
"SMU",
"CSO",
"CZL",
"KLC"
]
},
{
"name": "CNC (Cheng Lie Navigation)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"11DX"
],
"prefixes": []
},
{
"name": "Containerships",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"CSHP"
],
"prefixes": []
},
{
"name": "Cordelia Container Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CSYU"
],
"prefixes": [
"CSY"
]
},
{
"name": "COSCO",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"COSU"
],
"prefixes": [
"CCL",
"CSL",
"CSN",
"MTL",
"CBH",
"BSD",
"VEC"
]
},
{
"name": "Cosiarma S.p.A.",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CRAU"
],
"prefixes": []
},
{
"name": "Crane Worldwide Logistics",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MLCW"
],
"prefixes": []
},
{
"name": "Crowley Maritime",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CMCU",
"CAMN"
],
"prefixes": [
"CMC",
"SEF"
]
},
{
"name": "Dachser",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"DTRA"
],
"prefixes": []
},
{
"name": "Dalreftrans",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"DLTU"
],
"prefixes": [
"DLT"
]
},
{
"name": "Damco",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"DMCQ"
],
"prefixes": []
},
{
"name": "DB Schenker",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SHKK"
],
"prefixes": []
},
{
"name": "Deutsche Afrika-Linien (DAL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"DAYU"
],
"prefixes": [
"DAY",
"DDC"
]
},
{
"name": "DHL Global Forwarding",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"DHC2"
],
"prefixes": [
"DGF",
"TFH",
"DHZ"
]
},
{
"name": "Dongjin Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"11PG"
],
"prefixes": [
"DJL"
]
},
{
"name": "Dong Young Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"PCSL"
],
"prefixes": [
"DYL"
]
},
{
"name": "Dsv Ocean Transport",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"DSVF"
],
"prefixes": [
"SAT"
]
},
{
"name": "Econship",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ECNU"
],
"prefixes": [
"ECN"
]
},
{
"name": "ECUW",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ECUW"
],
"prefixes": []
},
{
"name": "Eimskip",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"EIMU"
],
"prefixes": []
},
{
"name": "EIO",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"EXPO"
],
"prefixes": []
},
{
"name": "Ellerman City Liners",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ECLU"
],
"prefixes": []
},
{
"name": "Emirates Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ESPU"
],
"prefixes": [
"ESD",
"ESP"
]
},
{
"name": "Emkay Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"EMKU"
],
"prefixes": [
"EMK"
]
},
{
"name": "Ethiopian Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": false
},
"maintenance": false,
"scacCodes": [
"ESLU"
],
"prefixes": [
"ESL"
]
},
{
"name": "Eukor",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"EUKO"
],
"prefixes": []
},
{
"name": "Evergreen",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"EGLV"
],
"prefixes": [
"EIS",
"EGH",
"EGS",
"HMC",
"EMC",
"EIT",
"IMT",
"LTI",
"UGM"
]
},
{
"name": "FESCO",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"FESO"
],
"prefixes": [
"FCC",
"FES"
]
},
{
"name": "G2 Ocean",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"GSSW"
],
"prefixes": []
},
{
"name": "Geodis Ocean",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"CIAU"
],
"prefixes": []
},
{
"name": "Gold Star Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"GSLU"
],
"prefixes": [
"GSL",
"GMO",
"JXJ",
"JXL"
]
},
{
"name": "Grimaldi Deep Sea S.P.A.",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"GRIU"
],
"prefixes": [
"GCN"
]
},
{
"name": "Hai Hua Shipping (HASCO)",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"12GE"
],
"prefixes": [
"HAH"
]
},
{
"name": "Hamburg Sud",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"SUDU"
],
"prefixes": [
"SUD",
"HAS"
]
},
{
"name": "Hapag-Lloyd",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"HLCU"
],
"prefixes": [
"TLE",
"TMM",
"ITA",
"LBI",
"HAM",
"IVL",
"HLB",
"HLC",
"HLX",
"LNX",
"LYK",
"MOM",
"CMU",
"CSQ",
"CSV",
"CAS",
"FAN",
"CPS",
"AZL",
"UAS",
"QIB",
"UAC",
"QNN",
"UAE"
]
},
{
"name": "Hecny Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"HYSL"
],
"prefixes": []
},
{
"name": "Hede Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": false
},
"maintenance": false,
"scacCodes": [
"HDUJ"
],
"prefixes": []
},
{
"name": "Hellmann Worldwide Logistics",
"active": true,
"activeTypes": {
"ct": false,
"bl": false,
"bk": false
},
"maintenance": true,
"scacCodes": [
"HIFI"
],
"prefixes": []
},
{
"name": "Heung-A Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"11QU"
],
"prefixes": [
"HAL",
"HLH"
]
},
{
"name": "Hillebrand Gori",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"HGLU"
],
"prefixes": []
},
{
"name": "Hoegh Autoliners",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"HUAU"
],
"prefixes": []
},
{
"name": "Hyundai Merchant Marine (HMM)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"HDMU"
],
"prefixes": [
"HDM",
"HMM",
"HDG",
"HMR",
"KOC"
]
},
{
"name": "Ignazio Messina",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"LMCU"
],
"prefixes": [
"LMC"
]
},
{
"name": "Independent Container Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"IILU"
],
"prefixes": [
"ICU"
]
},
{
"name": "Indus Container Lines (IDCL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": true,
"scacCodes": [
"IDCL"
],
"prefixes": []
},
{
"name": "Interasia Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"12AT"
],
"prefixes": [
"IAA"
]
},
{
"name": "JAS Worldwide (Ocean)",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"JASO"
],
"prefixes": []
},
{
"name": "Jin Jiang Shipping (SHJJ)",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"11WJ"
],
"prefixes": []
},
{
"name": "Kalypso Compagnia di Navigazione SpA",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"KCDU"
],
"prefixes": [
"KCD"
]
},
{
"name": "Kambara Kisen",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"KKCL"
],
"prefixes": [
"KMB"
]
},
{
"name": "Kawasaki Kisen Kaisha (K Line)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"KKLU"
],
"prefixes": [
"EKL",
"ESS",
"KKL",
"KXT",
"PXC",
"KLF",
"KLT"
]
},
{
"name": "Kintetsu World Express",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"KWEO"
],
"prefixes": []
},
{
"name": "Korea Marine Transport (KMTC)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"KMTU"
],
"prefixes": [
"KMT"
]
},
{
"name": "Kuehne + Nagel (KN)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"KHNN"
],
"prefixes": [
"SKN"
]
},
{
"name": "Lancer Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"LCUU"
],
"prefixes": [
"LCU"
]
},
{
"name": "Laurel Navigation",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"LNLU"
],
"prefixes": []
},
{
"name": "Leschaco",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"LEHO"
],
"prefixes": []
},
{
"name": "MacAndrews",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"MCAW"
],
"prefixes": []
},
{
"name": "Maersk",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MAEU"
],
"prefixes": [
"COZ",
"SCM",
"TOR",
"POC",
"PON",
"MRF",
"MRK",
"MRS",
"MSA",
"MSF",
"MSK",
"MSW",
"MCA",
"MCH",
"MVI",
"MWC",
"MWM",
"MCR",
"OCL",
"LOT",
"MAE",
"MAL",
"KNL",
"MIE",
"MMA",
"MNB",
"APM",
"FAA",
"FRL",
"KHJ",
"KHL",
"GRI",
"ENA",
"CNI",
"CAD",
"MCI"
]
},
{
"name": "Maersk Line Limited (MLL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MAEI"
],
"prefixes": []
},
{
"name": "Marguisa Shipping Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MGSU"
],
"prefixes": [
"MUO",
"OEX",
"CHL",
"MRG"
]
},
{
"name": "Mariana Express Lines (MELL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MEXU"
],
"prefixes": [
"MCT",
"MER",
"MEX"
]
},
{
"name": "Maritime Carrier Shipping (MACS)",
"active": true,
"activeTypes": {
"ct": false,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"MCSM"
],
"prefixes": [
"GAF",
"HST",
"MOC"
]
},
{
"name": "Maritime Marfret",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MFTU"
],
"prefixes": [
"MFR",
"MFT"
]
},
{
"name": "Matson Navigation Company (MATS)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MATS"
],
"prefixes": [
"CXC",
"HRZ",
"MAT",
"RSL"
]
},
{
"name": "Maxicon Container Line (MCL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MXCU"
],
"prefixes": [
"MXC"
]
},
{
"name": "Mediterranean Shipping Company (MSC)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MSCU",
"MEDU"
],
"prefixes": [
"MSC",
"MSD",
"MSM",
"MSB",
"MSG",
"MAD",
"MSP",
"MSZ",
"GTI",
"MED",
"MSY",
"MST",
"MSN",
"MSV"
]
},
{
"name": "Medkon Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MKLU"
],
"prefixes": [
"MKL"
]
},
{
"name": "Meratus Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"MRTU"
],
"prefixes": [
"MRT"
]
},
{
"name": "Minsheng Ocean Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"13CQ"
],
"prefixes": []
},
{
"name": "Mitsui O.S.K. Lines (MOL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"MOLU"
],
"prefixes": [
"MOG",
"MOL"
]
},
{
"name": "Namsung Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"NSRU"
],
"prefixes": [
"NSR",
"NSS"
]
},
{
"name": "National Shipping of America",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"NSHA"
],
"prefixes": []
},
{
"name": "Nauka Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"NOKU"
],
"prefixes": [
"NOK"
]
},
{
"name": "NE",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"NEDF",
"NPNE"
],
"prefixes": []
},
{
"name": "Neptune Pacific Direct Line (NPDL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"PDLU"
],
"prefixes": [
"PDL"
]
},
{
"name": "NewStar",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"NSTR"
],
"prefixes": []
},
{
"name": "Nile Dutch Africa Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"NIDU"
],
"prefixes": [
"NDS",
"NID"
]
},
{
"name": "Nippon Yusen Kaisha (NYK Line)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"NYKS"
],
"prefixes": []
},
{
"name": "Nirint Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"32GH"
],
"prefixes": [
"NIR"
]
},
{
"name": "North Sea Container Line (NCL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"NSCL"
],
"prefixes": [
"LOV"
]
},
{
"name": "Ocean Network Express (ONE)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ONEY"
],
"prefixes": [
"ONE",
"NYK",
"KKF",
"KKT",
"MOA",
"MOT",
"MOF",
"MOR",
"AKL",
"MOE",
"MOS"
]
},
{
"name": "Odyssey Logistics & Technology",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"OYLT"
],
"prefixes": []
},
{
"name": "Oman Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"OCLU"
],
"prefixes": []
},
{
"name": "Orient Overseas Container Line (OOCL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"OOLU"
],
"prefixes": [
"OOC",
"OOL"
]
},
{
"name": "Orient Star",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"OSTI"
],
"prefixes": []
},
{
"name": "Pacific International Lines (PIL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"PCIU",
"PABV"
],
"prefixes": [
"PCI",
"PIL",
"PID"
]
},
{
"name": "Pan Asia Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": true,
"scacCodes": [
"PALU"
],
"prefixes": [
"PAL"
]
},
{
"name": "Pan Continental Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"15AC"
],
"prefixes": [
"PCL"
]
},
{
"name": "Pan Ocean",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"POBU"
],
"prefixes": [
"POL"
]
},
{
"name": "Pasha Hawaii",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"PSHI"
],
"prefixes": [
"PGH"
]
},
{
"name": "Perma Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"PMLU"
],
"prefixes": [
"PML"
]
},
{
"name": "Polynesia Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"PLLU"
],
"prefixes": []
},
{
"name": "PSL Navegacao",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"PSL1"
],
"prefixes": []
},
{
"name": "Qatar Navigation Lines (QNL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"QNLU"
],
"prefixes": [
"QNL"
]
},
{
"name": "Regional Container Lines (RCL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"REGU"
],
"prefixes": [
"REG"
]
},
{
"name": "Rif Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"RIFU"
],
"prefixes": []
},
{
"name": "Romocean",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ROMO"
],
"prefixes": []
},
{
"name": "Route Planner",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SRRP"
],
"prefixes": [
"SRR"
]
},
{
"name": "Safmarine",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SAFM"
],
"prefixes": [
"CMB"
]
},
{
"name": "Salam Pacific Indonesia Lines (SPIL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"SPNU"
],
"prefixes": [
"SPN"
]
},
{
"name": "Samudera Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SIKU"
],
"prefixes": [
"SIK"
]
},
{
"name": "Sarjak Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SJKU"
],
"prefixes": [
"SJK"
]
},
{
"name": "Seaboard Marine",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"SMLU"
],
"prefixes": [
"SML"
]
},
{
"name": "Sea Hawk Lines (SHAL)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SHKU"
],
"prefixes": [
"SHK",
"SHA"
]
},
{
"name": "Sealand",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SEJJ",
"MCCQ",
"SEAU"
],
"prefixes": [
"SEA",
"MCP",
"MHH"
]
},
{
"name": "Sealead Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SJHH"
],
"prefixes": []
},
{
"name": "Sea Legend Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SEHP"
],
"prefixes": []
},
{
"name": "Seatrade",
"active": true,
"activeTypes": {
"ct": false,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"SGNV"
],
"prefixes": [
"FDD",
"SLJ"
]
},
{
"name": "Seino Logix Co",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SEIN"
],
"prefixes": []
},
{
"name": "SETH Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SSPH"
],
"prefixes": []
},
{
"name": "Shipco Transport",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SHPT"
],
"prefixes": []
},
{
"name": "Shipping Corporation of India (SCI)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SCIU"
],
"prefixes": [
"SII"
]
},
{
"name": "Sinokor",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SKLU"
],
"prefixes": [
"SKH",
"SKL",
"SKR",
"SKS"
]
},
{
"name": "Sinotrans Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"12IH"
],
"prefixes": [
"SNB",
"SNG",
"SNH"
]
},
{
"name": "SITC Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": false
},
"maintenance": false,
"scacCodes": [
"12PD"
],
"prefixes": [
"SIT"
]
},
{
"name": "SM Line (SML)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SMLM"
],
"prefixes": [
"SMC"
]
},
{
"name": "STC",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"SNTU"
],
"prefixes": [
"STB",
"SWT",
"TAB",
"TAI",
"UTC",
"SNI",
"SNT",
"BVI",
"DLK"
]
},
{
"name": "Sunmarine Shipping Services",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"BAXU"
],
"prefixes": [
"ARC",
"BAX"
]
},
{
"name": "Swire Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"CHVW"
],
"prefixes": [
"JSS",
"AWS"
]
},
{
"name": "Taicang Container Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": true,
"scacCodes": [
"32GG"
],
"prefixes": []
},
{
"name": "Tailwind Shipping Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TSHG"
],
"prefixes": [
"TAW"
]
},
{
"name": "Tarros",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"GETU"
],
"prefixes": [
"TAR",
"OWN",
"GET"
]
},
{
"name": "TOTE Maritime",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TOTE"
],
"prefixes": [
"NPR",
"SBG",
"STR"
]
},
{
"name": "Trans Asian Shipping Services",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TLXU"
],
"prefixes": [
"TLX"
]
},
{
"name": "TransContainer",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TKRU"
],
"prefixes": [
"TKR",
"RZD"
]
},
{
"name": "Transfar Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TJFH"
],
"prefixes": [
"TFL"
]
},
{
"name": "Transvision Shipping Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TVSU"
],
"prefixes": []
},
{
"name": "Tropical",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TSCW"
],
"prefixes": []
},
{
"name": "T.S. Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": false
},
"maintenance": false,
"scacCodes": [
"TXZJ",
"13DF",
"TSSU"
],
"prefixes": [
"TST",
"TSS"
]
},
{
"name": "Turkon",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"TRKU"
],
"prefixes": [
"TRK"
]
},
{
"name": "UWL",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"UWLD"
],
"prefixes": []
},
{
"name": "Vanguard Logistics",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"VGLT"
],
"prefixes": []
},
{
"name": "Vasco Maritime (VAS)",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"VMLU"
],
"prefixes": [
"VML"
]
},
{
"name": "VASI Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"VASU"
],
"prefixes": [
"VAS"
]
},
{
"name": "Volta Container Line",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"VCLU"
],
"prefixes": [
"VOT",
"VOL"
]
},
{
"name": "Wallenius Wilhelmsen",
"active": true,
"activeTypes": {
"ct": false,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"WLWH"
],
"prefixes": []
},
{
"name": "Wan Hai",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"WHLC",
"22AA",
"WHLU"
],
"prefixes": [
"WHL",
"WHS",
"TPC"
]
},
{
"name": "W.E.C. (West European Container) Lines",
"active": true,
"activeTypes": {
"ct": false,
"bl": false,
"bk": false
},
"maintenance": true,
"scacCodes": [
"WECU"
],
"prefixes": [
"WEC",
"WCX",
"HMK"
]
},
{
"name": "Westwood Shipping Lines",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"WWSU"
],
"prefixes": [
"WSL"
]
},
{
"name": "White Line Shipping",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"WTLU"
],
"prefixes": [
"WTL"
]
},
{
"name": "World Direct Shipping (WDS)",
"active": true,
"activeTypes": {
"ct": true,
"bl": false,
"bk": false
},
"maintenance": false,
"scacCodes": [
"WDSB"
],
"prefixes": []
},
{
"name": "Yang Ming",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"YMLU",
"YMPR",
"YMJA"
],
"prefixes": [
"YML",
"YMM"
]
},
{
"name": "Yusen Logistics",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"YASV"
],
"prefixes": []
},
{
"name": "ZIM",
"active": true,
"activeTypes": {
"ct": true,
"bl": true,
"bk": true
},
"maintenance": false,
"scacCodes": [
"ZIMU"
],
"prefixes": [
"ZCL",
"ZCS",
"ZIM",
"ZMO",
"ZWF"
]
}
]
}Note that most carriers accept CT, BL or BK numbers as input for tracking shipments, but there are some exceptions.
Track your first shipment
How to make a request
| Parameter | Type | Details |
|---|---|---|
| shipmentNumber (mandatory) | string | Can be a container number, a BL number or a BK number |
| shipmentType (optional) | Enum, string | Can be CT (for container), BL (for Bill of Lading) or BK (for Booking) |
| sealine (optional, recommended) | Enum, string | SCAC code of the sealine. Specifying this code will result in a quicker response time from the api. See list of supported SCAC codes. |
| route (true by default) | boolean | If set to TRUE, will return route data segments (array of coordinates following the path of the shipment from POL to POD). Setting to FALSE will result in lighter payload and quicker response time. |
| ais (true by default) | boolean | If set to TRUE, will return AIS data if available. Route parameter needs to also be set to TRUE. |
Understanding the api response
The response is composed of the following objects :
Metadata : generic information about the shipment (such as shipment number, status, shipping line)
Example :
{
"metadata": {
"shipmentType": "CT",
"shipmentNumber": "FANU1172910",
"sealine": "HLCU",
"sealineName": "Hapag-Lloyd",
"shippingStatus": "IN_TRANSIT",
"updatedAt": "2023-11-27T22:55:48Z"
},Locations : all locations that are involved in this shipment transportation.
Locations can be : POL (Port of Loading), POD (Port of Discharge) or any port of transhipment. Locations are listed in chronological order.
More information on the nature of each location is contained in the "route" json object detailed below.
Example :
"locations": [
{
"name": "Antwerp",
"state": "Flanders",
"country": "Belgium",
"countryCode": "BE",
"locode": "BEANR",
"coordinates": {
"lat": 51.22047,
"lng": 4.40026,
"updatedAt": null
},
"timezone": "Europe/Brussels"
},
{
"name": "Woerth am Rhein",
"state": "Rheinland-Pfalz",
"country": "Germany",
"countryCode": "DE",
"locode": "DEWOE",
"coordinates": {
"lat": 49.04888,
"lng": 8.25959,
"updatedAt": null
},
"timezone": "Europe/Berlin"
},
{
"name": "Charleston",
"state": "South Carolina",
"country": "United States",
"countryCode": "US",
"locode": "USCHS",
"coordinates": {
"lat": 32.77657,
"lng": -79.93092,
"updatedAt": null
},
"timezone": "America/New_York"
}
Route : key container locations namely POL and POD and associated dates, both estimated and actual
- Route json object provides the nature of each location : POL, POD or port of transhipment.
- Dates can be estimated or actual. This is where to find ETD (date at POL) and ETA (date at POD).
- PredictiveETA is only provided for POD when the container is within 3 days of its arrival. This data is calculated by Sinay algorithms based on historical AIS data, live port congestion and weather data. It is not provided by the shipping lines.
Example :
],
"route": {
"prepol": {
"location": {
"name": "Woerth am Rhein",
"state": "Rheinland-Pfalz",
"country": "Germany",
"countryCode": "DE",
"locode": "DEWOE",
"coordinates": {
"lat": 49.04888,
"lng": 8.25959,
"updatedAt": null
},
"timezone": "Europe/Berlin"
},
"date": "2023-10-27T09:17:00Z",
"actual": true,
"predictiveEta": null
},
"pol": {
"location": {
"name": "Antwerp",
"state": "Flanders",
"country": "Belgium",
"countryCode": "BE",
"locode": "BEANR",
"coordinates": {
"lat": 51.22047,
"lng": 4.40026,
"updatedAt": null
},
"timezone": "Europe/Brussels"
},
"date": "2023-11-07T17:38:00Z",
"actual": true,
"predictiveEta": null
},
"pod": {
"location": {
"name": "Charleston",
"state": "South Carolina",
"country": "United States",
"countryCode": "US",
"locode": "USCHS",
"coordinates": {
"lat": 32.77657,
"lng": -79.93092,
"updatedAt": null
},
"timezone": "America/New_York"
},
"date": "2023-11-27T13:18:00Z",
"actual": true,
"predictiveEta": null
},
"postpod": {
"location": null,
"date": null,
"actual": null,
"predictiveEta": null
}
},Facilities : list of all facilities associated to locations (terminals, equipment...) when provided by shipping lines
Vessels : all vessels involved in this shipment transportation
Vessels are listed in chronological order.
Example :
"vessels": [
{
"name": "MISSOURI EXPRESS",
"imo": 9349552,
"callSign": "WDM2203",
"mmsi": 367781000,
"flag": "US"
}Containers : detailed information about container locations and events
- Events are associated to EventTypes (gate in, gate out, loaded...) and dates.
- Dates can be estimated or actual.
- New events can be added along the shipment journey. This is why querying the api regularly is key to maintaining up to date data.
Example :
"containers": [
{
"number": "FANU1172910",
"isoCode": "45G1",
"status": "IN_TRANSIT",
"events": [
{
"location": {
"name": "Woerth am Rhein",
"state": "Rheinland-Pfalz",
"country": "Germany",
"countryCode": "DE",
"locode": "DEWOE",
"coordinates": {
"lat": 49.04888,
"lng": 8.25959,
"updatedAt": null
},
"timezone": "Europe/Berlin"
},
"facility": null,
"description": "Gate out empty",
"eventType": "EQUIPMENT",
"eventCode": "GTOT",
"status": "CEP",
"date": "2023-10-27T09:17:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "LAND",
"transportType": "TRUCK",
"vessel": null,
"voyage": null
},
{
"location": {
"name": "Woerth am Rhein",
"state": "Rheinland-Pfalz",
"country": "Germany",
"countryCode": "DE",
"locode": "DEWOE",
"coordinates": {
"lat": 49.04888,
"lng": 8.25959,
"updatedAt": null
},
"timezone": "Europe/Berlin"
},
"facility": null,
"description": "Arrival in",
"eventType": "TRANSPORT",
"eventCode": "ARRI",
"status": "LTS",
"date": "2023-11-02T14:31:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "LAND",
"transportType": "TRUCK",
"vessel": null,
"voyage": null
},
{
"location": {
"name": "Woerth am Rhein",
"state": "Rheinland-Pfalz",
"country": "Germany",
"countryCode": "DE",
"locode": "DEWOE",
"coordinates": {
"lat": 49.04888,
"lng": 8.25959,
"updatedAt": null
},
"timezone": "Europe/Berlin"
},
"facility": null,
"description": "Departure from",
"eventType": "TRANSPORT",
"eventCode": "DEPA",
"status": "LTS",
"date": "2023-11-03T20:40:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "LAND",
"transportType": null,
"vessel": null,
"voyage": null
},
{
"location": {
"name": "Antwerp",
"state": "Flanders",
"country": "Belgium",
"countryCode": "BE",
"locode": "BEANR",
"coordinates": {
"lat": 51.22047,
"lng": 4.40026,
"updatedAt": null
},
"timezone": "Europe/Brussels"
},
"facility": null,
"description": "Arrival in",
"eventType": "TRANSPORT",
"eventCode": "ARRI",
"status": "CGI",
"date": "2023-11-07T17:38:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "LAND",
"transportType": null,
"vessel": null,
"voyage": null
},
{
"location": {
"name": "Antwerp",
"state": "Flanders",
"country": "Belgium",
"countryCode": "BE",
"locode": "BEANR",
"coordinates": {
"lat": 51.22047,
"lng": 4.40026,
"updatedAt": null
},
"timezone": "Europe/Brussels"
},
"facility": null,
"description": "Loaded",
"eventType": "EQUIPMENT",
"eventCode": "LOAD",
"status": "CLL",
"date": "2023-11-12T20:01:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "SEA",
"transportType": "VESSEL",
"vessel": {
"name": "MISSOURI EXPRESS",
"imo": 9349552,
"callSign": "WDM2203",
"mmsi": 367781000,
"flag": "US"
},
"voyage": "073W"
},
{
"location": {
"name": "Antwerp",
"state": "Flanders",
"country": "Belgium",
"countryCode": "BE",
"locode": "BEANR",
"coordinates": {
"lat": 51.22047,
"lng": 4.40026,
"updatedAt": null
},
"timezone": "Europe/Brussels"
},
"facility": null,
"description": "Vessel departed",
"eventType": "TRANSPORT",
"eventCode": "DEPA",
"status": "VDL",
"date": "2023-11-12T21:48:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "SEA",
"transportType": "VESSEL",
"vessel": {
"name": "MISSOURI EXPRESS",
"imo": 9349552,
"callSign": "WDM2203",
"mmsi": 367781000,
"flag": "US"
},
"voyage": "073W"
},
{
"location": {
"name": "Charleston",
"state": "South Carolina",
"country": "United States",
"countryCode": "US",
"locode": "USCHS",
"coordinates": {
"lat": 32.77657,
"lng": -79.93092,
"updatedAt": null
},
"timezone": "America/New_York"
},
"facility": null,
"description": "Vessel arrived",
"eventType": "TRANSPORT",
"eventCode": "ARRI",
"status": "VAD",
"date": "2023-11-27T13:18:00Z",
"isActual": true,
"isAdditionalEvent": false,
"routeType": "SEA",
"transportType": "VESSEL",
"vessel": {
"name": "MISSOURI EXPRESS",
"imo": 9349552,
"callSign": "WDM2203",
"mmsi": 367781000,
"flag": "US"
},
"voyage": "073W"
},
{
"location": {
"name": "Charleston",
"state": "South Carolina",
"country": "United States",
"countryCode": "US",
"locode": "USCHS",
"coordinates": {
"lat": 32.77657,
"lng": -79.93092,
"updatedAt": null
},
"timezone": "America/New_York"
},
"facility": null,
"description": "Discharge",
"eventType": "EQUIPMENT",
"eventCode": "DISC",
"status": "CDD",
"date": "2023-11-27T13:18:00Z",
"isActual": false,
"isAdditionalEvent": false,
"routeType": "SEA",
"transportType": "VESSEL",
"vessel": {
"name": "MISSOURI EXPRESS",
"imo": 9349552,
"callSign": "WDM2203",
"mmsi": 367781000,
"flag": "US"
},
"voyage": "073W"Get the complete list of events here :
routeData : array of coordinates from POL to POD allowing you to map the shipment route and position
Coordinates : current position of the vessel transporting the shipment.
AIS data : AIS locations and ship event details for vessel departures and arrivals.
Container Tracking API Best Practices
Here is a quick list of best practices to optimize Container Tracking API response time and data quality.
Track By BL reference
To optimize tracking costs, we recommend using BL numbers to track shipments (if you can) : you will only be charged for 1 shipment when tracking by BL regardless of the number of associated containers.
Specify the sealine in your request
If you can, specify the sealine of the shipment (SCAC code format) in your request parameters to refine the tracking search. This will ensure a faster response time and often yield better results. If you cannot specify the sealine, our system will run an autodetection which can sometimes fail even if the shipment number entered is valid.
Retry failed requests
- Retry tracking shipments when receiving a 504 timeout error. When fetching data takes too long, our system can cancel the request and return a 504 timeout response - we recommend retrying any 504 calls after less than 60 minutes as the data will be available in our cache.
- Retry shipments when receiving a 200 SEALINE_HASNT_PROVIDE_INFO response : most requests will yield results once data becomes available.
Poll the api regularly
The Container Tracking API polls data from various sources including shipping line data directly. Data is generally refreshed every 6 to 24 hours depending on the data source.
We recommend calling the api every 6 hours to get the most accurate data.
We encourage our PRO & ENTREPRISE users to set up webhooks to get automatic updates on any event changes.
React to errors
The complete list of possible errors is available here.
In case of error, always retry your request and enter optional data if you can (sealine SCAC code).