OccupancyDto

Vessel occupancy section. Always contains both visits (paginated, for Gantt rendering) and top_vessels (aggregated, for table rendering). Use view_mode in the query block to determine which to display.

{
    "display_date_start": "2026-02-22",
    "display_date_end": "2026-03-07",
    "gap_time_total": 170.4,
    "gap_time_avg": 17,
    "pagination": {
        "total_days": 30,
        "page": 1,
        "page_size": 14,
        "day_start": 1,
        "day_end": 14
    },
    "visits": [
        {
            "imo_number": "9128403",
            "vessel_name": "Nordic Hawk",
            "ship_type_level_3": "Bulk Carrier",
            "vessel_flag": "Republic of Cyprus",
            "vessel_flag_code": "CYP",
            "arrival_time": "2026-03-27T08:00:00+00:00",
            "departure_time": "2026-03-28T09:42:00+00:00",
            "hours_at_berth": 25.7
        }
    ],
    "gaps": [
        {
            "start_time": "2026-03-04T12:08:50+00:00",
            "end_time": "2026-03-04T16:04:00+00:00",
            "gap_duration": 3.92
        }
    ],
    "top_vessels": [
        {
            "imo_number": "9128403",
            "vessel_name": "Nordic Hawk",
            "ship_type_level_3": "Bulk Carrier",
            "visit_count": 4,
            "total_dwell_time": 102.8,
            "avg_dwell_time": 25.7
        }
    ]
}