# Port occupation

> Port occupation is the number of vessels currently inside a port polygon, berths included and waiting zones excluded, divided by the historical maximum for that port; the gap with the mean compares it with the usual 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}`](/en/api/ports-intelligence/reference/get-port-details) returns the details and berth occupation of a port.

::callout{type="warning"}
The Ports Intelligence API is in beta. It is subject to change and may not be fully stable: use it with caution in production environments.
::

## 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:

```text
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:

1. The vessels present in the port are counted every hour, by vessel type.
2. The mean and the maximum historical vessel counts are computed for each port.
3. 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:

```text
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.

::callout{type="info"}
For occupation data on other ports, on custom port areas or on vessel types outside the default access, [contact the Safecube team](https://app.safecube.ai/contact).
::

- **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
