Port occupation
The Ports Intelligence API returns the occupation of a port — how full it is compared with its history — together with the port details and the vessels currently in port. The occupation data covers a standard set of more than 720 major commercial ports, accessible by default with your API key. The endpoint GET /ports/{unlocode} returns the details and berth occupation of a port.
Occupation percentage
Port occupation is expressed as a percentage: the number of vessels currently in the port, divided by the maximum number of vessels ever recorded in that port.
For a port whose historical maximum is 28 vessels and which currently holds 15 vessels:
occupation = 15 / 28 = 53.57%
Area of the port
A vessel is counted as in port, and included in the occupation, when it is located inside the port polygon.
- The port polygon includes every berth area.
- The port polygon excludes the waiting zones.
How the statistics are computed
The capacity and the occupation of each port are computed in three steps:
- The vessels present in the port are counted every hour, by vessel type.
- The mean and the maximum historical vessel counts are computed for each port.
- The current number of vessels, from real-time data, is compared with those historical statistics to derive the occupation percentage — current count against maximum — and the gap with the mean.
The data is produced by the Safecube data science team from several sources, including AIS satellite data and the UNECE port list.
Gap with the mean
Besides the current occupation, the API gives the gap between the current occupation and the mean historical occupation of the port:
gap with mean = current occupation - mean historical occupation
It shows how much busier or quieter the port is than usual.
For Le Havre (FRLEH), with a historical mean of 15 vessels and a historical maximum of 28 vessels:
- the mean occupation is
15 / 28 = 53.57%; - with a current occupation of 80%, the gap with the mean is
80% - 53.57% = 26.43%.
A gap of 26.43% does not mean the port holds 26.43% more vessels than usual: it means the port is 26.43% more congested than usual.
Covered ports
The ports covered by default are listed below by their UN/LOCODE, grouped by the two-letter country code that starts it.
- AE: AEAUH, AEJEA, AESHJ
- AG: AGSJO
- AO: AOLAD
- AR: ARSFN, ARZAE
- AS: ASPPG
- AU: AUADL, AUBNE, AUDPO, AUDRW, AUFRE, AUMKY, AUNTL, AUPKL
- AW: AWAUA
- BB: BBBGI
- BE: BEANR, BEBGS, BEGNE, BEHEX, BEMHN, BEMRK, BEOEL, BEOST, BEWJG, BEZEE, BEZEL
- BG: BGBOJ, BGVAR
- BH: BHKBS
- BJ: BJCOO
- BN: BNMUA
- BR: BRPNG, BRRIG, BRRIO, BRSSA, BRSSZ, BRSUA, BRVIX
- BS: BSFPO, BSNAS
- CA: CAHAL, CANNO, CAVAN
- CG: CGPNR
- CI: CIABJ
- CL: CLARI, CLIQQ, CLMJS, CLPMC, CLSAI
- CM: CMDLA
- CN: CNCAN, CNHUA, CNLYG, CNNGB, CNQDG, CNSHG, CNTXG, CNXMG, CNXNA, CNZOS
- CO: COBUN, COCTG, COSMR
- CR: CRLIO
- CW: CWWIL
- CY: CYFMG, CYLCA, CYLMS, CYVAS
- DE: DEBKE, DEBLM, DEBMK, DEBRB, DEBRE, DEBRV, DEBUZ, DECUX, DEELS, DEEME, DEHAM, DEHGL, DEHOD, DEKEL, DEKOP, DELBC, DEMUK, DENHA, DEOSR, DERSK, DESTL, DESTS, DETRV, DEVIW, DEWIS, DEWVN
- DJ: DJJIB
- DK: DKAAL, DKAAR, DKCPH, DKEBJ, DKFDH, DKFDV, DKFRC, DKKAL, DKKOG, DKKOL, DKLIN, DKNAK, DKNBG, DKRAN, DKRNN, DKSKA, DKTHN, DKVOR, DKVRE
- DO: DOSDQ
- DZ: DZDJE
- EC: ECESM, ECMEC
- EE: EEBEK, EEKND, EEMUG, EEPAS, EEPLA, EEPLS, EERON, EESLM, EEVEB
- EG: EGADA, EGALY, EGEDK
- ES: ESAER, ESAGP, ESALC, ESALG, ESAVS, ESBCN, ESBIO, ESCAD, ESCAR, ESCAS, ESFRO, ESGAR, ESGIJ, ESHUV, ESLCG, ESLEI, ESLEO, ESMOT, ESPAS, ESPMI, ESPMN, ESRTA, ESSAG, ESSDR, ESTAR, ESVGO, ESVLC
- FI: FIAJO, FIHKO, FIHMN, FIKAS, FIKJO, FIKOK, FIKTK, FIKVH, FINLI, FIOUL, FIPRV, FIRAA, FIRAU, FIROY, FITKU, FIVAA, FIVSS
- FJ: FJSUV
- FR: FRBAI, FRBES, FRCQF, FRDKK, FRDON, FRFOS, FRHON, FRIRK, FRLAV, FRLEH, FRLPE, FRLRT, FRLSO, FRMRS, FRMTX, FRPDB, FRSET, FRSML, FRSNR, FRYNE
- GA: GALBV
- GB: GBABD, GBAVO, GBBEL, GBBLY, GBBOS, GBBRK, GBCOW, GBDAG, GBDVR, GBEAM, GBERI, GBFAW, GBFXT, GBGLW, GBGOO, GBGRG, GBGRK, GBGSY, GBGTY, GBHRW, GBHTP, GBHUL, GBIMM, GBIOG, GBIPS, GBKGH, GBKLN, GBKLR, GBKYL, GBLDY, GBLEI, GBLER, GBLGP, GBLIV, GBMLF, GBNFT, GBNHO, GBNPT, GBPFT, GBPHD, GBPLY, GBPME, GBPOO, GBPRU, GBPTL, GBRCS, GBRID, GBSEA, GBSFW, GBSHO, GBSHS, GBSOU, GBSSS, GBSUN, GBTEE, GBTHP, GBTIL, GBTNM, GBTRA, GBWPN, GBWPT
- GD: GDSTG
- GE: GEBUS, GEPTI
- GH: GHTEM
- GI: GIGIB
- GM: GMBJL
- GN: GNCKY
- GP: GPPTP
- GQ: GQBSG, GQSSG
- GR: GRAGT, GRASS, GREEU, GRGPA, GRIOS, GRJMK, GRJNX, GRJSY, GRJTR, GRKLM, GRMLO, GRNKV, GRPER
- HR: HRSPU
- HT: HTPAP
- IE: IERIN, IEWAT, IEWHI
- IL: ILASH, ILHFA
- IN: INBOM, INENR, INMAA, INMUN, INPAV
- IQ: IQUQR
- IS: ISAKU, ISBIL, ISGRT, ISREY
- IT: ITAOI, ITAUG, ITBDS, ITBRI, ITCAG, ITCTA, ITGIT, ITGOA, ITLIV, ITMDC, ITMLZ, ITMNF, ITNAP, ITOLB, ITPFX, ITPIO, ITPMO, ITPNG, ITPTO, ITRAN, ITSAL, ITSPE, ITSVN, ITTAR, ITTRS, ITVCE, ITVDL
- JM: JMKIN
- JO: JOAQJ
- JP: JPCHB, JPGAM, JPHHR, JPHIC, JPHIJ, JPHKT, JPHTC, JPKND, JPMOJ, JPNAN, JPNGO, JPOMZ, JPOSA, JPSAK, JPTHS, JPUKB, JPYKK, JPYOK, JPYOS
- KE: KEMBA
- KN: KNBAS
- KR: KRINC, KRKUV, KRMAS, KRMOK, KRPTK, KRPUS, KRUSN
- KW: KWMEA
- LB: LBBEY
- LC: LCCAS
- LK: LKHBA
- LR: LRMLW
- LT: LTKLJ
- LV: LVLPX, LVRIX, LVVNT
- LY: LYMRA
- MA: MACAS, MATNG
- ME: MEBAR
- MG: MGTOA
- MH: MHMAJ
- MM: MMRGN
- MP: MPSPN
- MQ: MQFDF
- MR: MRNKC
- MT: MTMLA
- MU: MUPLU
- MX: MXATM, MXLZC, MXVER
- MY: MYBKI, MYKCH, MYPKG
- MZ: MZMPM
- NA: NAWVB
- NC: NCNOU
- NG: NGLOS
- NI: NICIO
- NL: NLHAG, NLHAN, NLHAR, NLHAS, NLHFW, NLHRN, NLHVH, NLIJM, NLISM, NLKAI, NLKAM, NLLEY, NLLMR, NLLWR, NLMAK, NLMSL, NLMSV, NLNGV, NLNKK, NLODT, NLOGP, NLOHI, NLOVN, NLPER, NLROZ, NLRTM, NLSCI, NLSLU, NLSVG, NLTHO, NLTMZ, NLTNZ, NLTRO, NLTSL, NLURK, NLVLA, NLVLI, NLVSN, NLWAL, NLWRG, NLWSO, NLWSP, NLWTN, NLZAA, NLZBB, NLZBW, NLZWO, NLZWS, NLZWW
- NO: NOAES, NOAGO, NOAHM, NOALF, NOAVE, NOBGO, NOBJF, NOBNN, NOBOO, NOBTH, NOBVK, NOBVR, NODRM, NODUS, NOEGE, NOEGG, NOEKF, NOELN, NOEYD, NOFAN, NOFAU, NOFIS, NOFLO, NOFNE, NOFNN, NOFOL, NOFOR, NOFRK, NOFRO, NOFRS, NOGLO, NOHAU, NOHAV, NOHEK, NOHEY, NOHFT, NOHIT, NOHLA, NOHLE, NOHOG, NOHOL, NOHOR, NOHOT, NOHRD, NOHSA, NOHSO, NOHVG, NOHYR, NOKAR, NOKKN, NOKMO, NOKMY, NOKON, NOKOP, NOKRV, NOKSU, NOKVD, NOLAG, NOLAR, NOLKA, NOLKN, NOLNS, NOLOD, NOLOV, NOLRI, NOLSU, NOMAN, NOMAY, NOMEL, NOMJF, NOMOL, NOMON, NOMQN, NOMSD, NOMSS, NOMYR, NONSF, NONVK, NONZI, NOOLN, NOOSL, NOOSY, NOOTA, NOPOR, NORAF, NOREK, NORSH, NORVK, NORYF, NOSAG, NOSAS, NOSAT, NOSAY, NOSJH, NOSKN, NOSKX, NOSLG, NOSLV, NOSLX, NOSOR, NOSOY, NOSPG, NOSPV, NOSRP, NOSSJ, NOSTB, NOSTU, NOSVE, NOSVG, NOSVI, NOTAE, NOTAV, NOTBO, NOTOS, NOTRA, NOTRD, NOUTH, NOVAE, NOVER, NOVSM, NOVST
- NZ: NZAKL, NZLYT, NZNSN, NZWLG
- OM: OMSLL, OMSOH
- PA: PACTB, PAMIT
- PE: PECLL
- PF: PFPPT
- PG: PGLAE, PGPOM
- PH: PHBTG
- PK: PKKHI
- PL: PLGDN, PLGDY, PLPLC, PLSWI, PLSZZ
- PR: PRSJU
- PT: PTAVE, PTBRO, PTFDF, PTLEI, PTLIS, PTSET, PTSIE
- RE: REREU
- RO: ROAGI, ROCND, ROMED, ROMID, ROMUR, ROOVI, ROSUL
- RU: RUAZO, RUBLT, RUBNK, RUGDZ, RUKDT, RUKGD, RUKZP, RULED, RULOM, RUMMK, RUNVS, RUPRI, RUROV, RUTAG, RUTAM, RUTMR, RUTUA, RUULU, RUVVO, RUYEY, RUZAL
- SA: SAJED
- SD: SDPZU
- SE: SEAHU, SEASP, SEBRO, SEGOT, SEGVX, SEHAD, SEHAH, SEHAN, SEHEL, SEHLD, SEJAT, SEKAN, SEKLR, SELAA, SELGD, SELLA, SEMMA, SENRK, SENYN, SEOSK, SEOXE, SEROR, SESOE, SESOL, SESTE, SESTO, SEVAG, SEWAL
- SG: SGSIN
- SH: SHASI
- SI: SIKOP
- SL: SLFNA
- SN: SNDKR
- SR: SRPBM
- SV: SVAQJ
- SX: SXPHI
- SY: SYLTK
- TG: TGLFW
- TH: THLCH
- TN: TNRDS
- TO: TOTBU
- TR: TRALI, TRAMR, TRAUT, TRAYT, TRBAK, TRBDM, TRDRC, TRERE, TREYP, TRGEB, TRGEM, TRHAY, TRIDS, TRISK, TRIZM, TRKAR, TRKFZ, TRMER, TRNEM, TRPEN, TRSRK, TRSSX, TRTEK, TRTOC, TRTUZ, TRYAL, TRYAR, TRZEY, TRZON
- TT: TTPOS
- TW: TWKEL, TWTPE, TWTXG
- UA: UADNB, UAERD, UAILK, UAKEH, UAKHE, UAMPW, UANLV, UAOCT, UAODS, UAYUZ, UAZUR
- US: USBAL, USBNC, USBPT, USCHS, USDET, USDVV, USGLS, USHOU, USHVN, USILM, USJAX, USLGB, USMOB, USNTD, USNYC, USPEF, USPHL, USSAV, USSSI, USTIW
- UY: UYMVD
- ZA: ZACPT, ZADUR, ZAZBA