1. Home
  2. Port Congestion
  3. Statistics

Statistics

The port congestion statistics endpoint takes a un location code as an argument and gives back the current situation in the port. This is the average, median, maximum and minimum values of anchorage- and berth time in the last 30 days.

Note that not all ports are supported, check section available ports to see the ones that are.

The endpoint can be used like below:

GET /ports/{un_location_code}/port-congestions/statistics

The result comes back as shown below, where the duration-format follows ISO-8601.

GET /ports/USLAX/port-congestions/statistics

{
  "un_location_code": "USLAX",
  "anchorage_time": {
    "average": "P4DT19H20M09S",
    "median": "P1DT20H09M42S",
    "min": "P0DT01H00M52S",
    "max": "P19DT14H09M02S"
  },
  "berthing_time": {
    "average": "P5DT04H59M37S",
    "median": "P3DT22H30M00S", 
    "min": "P0DT06H39M37S",
    "max": "P18DT01H04M45S"
  }
}

The format of the duration can be a bit tricky. Here’s a short breakdown, of this duration P4DT19H20M09S

P – stands for plus, and indicates a positive duration. All port congestion durations will have a P, as we don’t work with negative durations.

4D – Number of days in the duration

T – Indicates that the time (hours, minutes, seconds) duration now starts

19H – Number of hours in the duration

20M – Number of minutes in the duration

09S – Number of seconds in the duration