1. Home
  2. Protected: OceanIO
  3. Protected: Use cases
  4. Using Vessel Schedules

Using Vessel Schedules

Using Vessel Schedules

The OceanIO platform offers schedules to let you choose the Carrier with the most suited schedule. Schedules can be used utilized in various ways. For instance:

  • To determine which schedule to select in a planning situation

  • To check a givens vessels schedule

Check schedules for a port pair

To check which schedules are available between a port of loading and port of destination use the GET /schedules endpoint. This endpoint returns all possible schedules between 2 ports.

Three different options to return the schedules are supported:

  • CURRENT: When using this option only active schedules will be displayed, which means that the given origin event has to be in the past i.e “ACT”. And the given destination must be in the future, i.e “EST”

  • NEXT: If this option is used both the given origin and destination events has to be in the future, i.e “EST”. So only schedules which is going to happen will be returned here.

  • TIMEINTERVAL: for timeinterval a begin_datetime and end_datetime is needed and then only schedules within that timeframe is shown.

Besides these options, a filter with a carrier scac code can be used. This means that only schedules for that specific carrier will be shown, given that the carrier scac code is supported by GH.

Check schedule for a specific Vessel

To check a schedule for a specific vessel use the GET /schedules/{vessel_IMO_Number} This endpoint returns the schedules for the specific vessel requested. Here it is possible to filter for a specific carrier scac code if it is supported by GH.

FAQ:

  1. Q: For which time frame am I getting schedules?
    A: For a minimum of 4 weeks and a maximum of 8 weeks
  2. Q: How many ports within the schedule service are you supporting?
    A: The schedule service supports all ports for all supported Carriers
  3. Q: How many Carriers am I getting schedules for?
    A: Vessel schedules are currently provided for 14 carriers. These are: CMA,COSCO,CROWLEY,EVERGREEN,HAMBURGSUD,HAPAG,HMM21,MAERSK,MSC,ONE,PIL,WAN_HAI,YANGMING & ZIM.