Developer Portal
Insights
PurpleTRACMTIPodium
Other
Other
  • Weather
Insights
PurpleTRACMTIPodium
Other
Other
  • Weather
    • Start Here
      • API Overview
      • Getting Started
      • Authentication
      • Quick Start
      • Testing & Sandbox
    • Concepts & Terminology
      • Concepts & Terminology
      • Notifications & Webhooks
      • Errors & Status Codes
      • Pagination & Filtering
      • Versioning & Deprecation
      • Changelog
    • Reference Data
      • Vessel Types
      • Vessel Classes
      • Vessel Statuses
      • Zone & Port Types
    • Build & Operate
      • AI Assistants & Agents
      • FAQ
      • SDKs & Code Generation
    • Vessel & Voyage
      • Overview
      • Vessel Insights
        • Overview
        • Vessel Search
        • Vessel Characteristics
      • Voyage Insights
        • Overview
        • Worked Examples
        • Vessel Port Calls
        • Vessel Zone & Port Events
        • Vessel AIS Reporting Gaps
        • Vessel STS Pairings
        • Positional Discrepancies
        • Port State Control
      • Vessel Positions
        • Vessel Positions
        • Historical Vessel Track
        • Latest Vessel Positions
      • Vessel Notifications
        • Worked Examples
        • Get Vessel Notification Subscriptions
        • Create Vessel Notification Subscription
        • Get Vessel Notification Subscription
        • Edit Vessel Notification Subscription
        • Get Vessel Notifications by Subscription ID
        • Get All Vessel Notifications
        • Delete Vessel Notification Subscription
    • Port & Trade
      • Overview
      • Choosing Port Endpoints
      • Port Insights
        • Port Insights
        • Berth Calls by Port
        • Inbound Vessels
      • Port Analytics
        • Port Analytics
        • Port Analytics: Worked Examples
        • Berth KPIs
        • Berth Details
        • Port Arrival & Departure Analytics
    • Domain & Fleet
      • Overview
      • Choosing Zone Endpoints
      • Zone Insights
        • Overview
      • Zone Analytics
        • Zone Analytics
        • Zone Analytics: Worked Examples
        • Zone Entry & Exit Analytics
      • Fleet Management
        • Fleet Management
        • Fleet Management: Worked Examples
        • List Fleets
        • Create Fleet
        • Get Fleet Details
        • Delete Fleet
        • Update Fleet
        • List Fleet Vessels
        • Get Fleet Composition
        • List Fleet Events
      • Custom Zones
        • Custom Zones
        • Create Custom Zone
        • Edit Custom Zone
    • Zones & Ports
      • Overview
      • Zone & Port Insights
        • Zone & Port Search
        • Get Single Zone or Port
        • Zone & Port Traffic
        • Vessels in Zone or Port
      • Zone & Port Notifications
        • Zone & Port Notifications
        • Zone & Port Notifications: Worked Examples
        • Create Zone & Port Notification Subscription
        • Get Zone & Port Notification Subscriptions
        • Edit Zone & Port Notification Subscription
        • Delete Zone & Port Notification Subscription
        • Get Zone & Port Notification Subscription
        • Search Zone & Port Notifications
        • Get Zone & Port Notifications by Subscription ID
        • Get All Zone & Port Notifications
    • Schemas
      • VesselTankerCharacteristicsResponse
      • ImoBatchSearchResponse
      • ReportedDestination
      • AisFieldDeltaNavigationalStatus
      • AisFieldDeltaErrorResponse
      • BerthDetailsDto
      • BerthListQuery
      • BerthPortInfoDto
      • BerthSummaryDto
      • DwellTimeDataPointDto
      • OccupancyDto
      • PortAnalyticsItem
      • PortAnalyticsQuery
      • PortAnalyticsResponse
      • PortAnalyticsTotals
      • TopVisitorDto
      • VesselTypeMixDto
      • ZoneAnalyticsItem
      • ZoneAnalyticsQuery
      • ZoneAnalyticsResponse
      • ZoneDetail
      • PortDetail
      • PositionReport
      • PositionalDiscrepancyEvent
      • AisSpoofingErrorResponse
      • AisSpoofingVesselInformation
      • VesselPortsFilter
      • ZoneDetails
      • PortDetails
      • CustomZoneDetails
      • CircleDetails
      • PortEventDetails
      • PortCallEventDetails
      • BerthInformationPortCall
      • PortVessel
      • PortListResponse
      • ZoneDefinitionResponse
      • CustomZoneResponse
      • ArrivalsDeparturesResponse
      • VesselsInZonePortResponse
      • BerthEventsResponse
      • VoyagePortCallsResponse
      • VoyageZonePortEventsResponse
      • CustomZoneRequest
      • CustomCircle
      • ZoneServiceErrorResponse
      • ZoneServiceVesselInformation
      • VesselIdentifier
      • LatestVesselFilter
      • CircleZone
      • PolygonZone
      • GeographicFilter
      • HistoricalPositionSearchRequest
      • LatestPositionSearchRequest
      • VesselInfo
      • MatchedDestination
      • ConsolidatedPosition
      • CpsApiErrorResponse
      • CpsApiPaginationMeta
      • CpsApiNavigationalStatus
      • AnalyticsServiceErrorResponse
      • ResponseMeta
      • FlagDetail
      • CountryOfBuild
      • Ownership
      • VesselTankerCharacteristics
      • VesselCharacteristicsResponse
      • VesselSummary
      • VesselSearchResponse
      • ImoBatchSearchMeta
      • ImoBatchSearchSummary
      • ImoVesselSummary
      • ImoErrorEntry
      • ImoBatchSearchData
      • AssetInformationServiceErrorResponse
      • AssetInformationServiceDimensions
      • AssetInformationServiceVesselCharacteristics
      • EmailSettingsDTO
      • VesselFilterRequestDTO
      • ZonePortFilterRequestResponseDTO
      • SettingsResponseDto
      • SubscriptionResponseDTO
      • NotificationResponseDTO
      • EventNotificationServiceMetaData
      • BerthEventDetails
      • PscInspection
      • CustomPolygon
      • ZoneServiceMeta
      • HistoricalPositionsResponse
      • FleetListResponse
      • FleetListMeta
      • FleetSummary
      • FleetItem
      • VesselPosition
      • FleetVesselItem
      • FleetDetailMeta
      • FleetDetail
      • AnalyticsServiceVesselInformation
      • FailedVessel
      • CreateFleetV2Request
      • CreateFleetV2Response
      • UpdateFleetV2Request
      • FleetManagementApiMeta
      • FleetManagementApiErrorResponse
      • AssetInformationServiceCountryOfBuild
      • BerthDetailMetaDto
      • FleetEventNavigationalStatus
      • LegacyStsPairingsResponse
      • VesselZonesFilter
      • EventNotificationServiceErrorResponse
      • VesselAisReportingGapsFilter
      • GapReportingErrorResponse
      • VesselStsPairingsFilter
      • VoyageVesselInformation
      • StsPairingsResponse
      • VesselPositionalDiscrepanciesFilter
      • VesselDraughtChangeFilter
      • PscInspectionServiceErrorResponse
      • ReportingStatus
      • VesselAisDestinationChangeFilter
      • DaysNotReportingRange
      • VesselAisEtaChangeFilter
      • AnalyticsServiceMeta
      • VesselMmsiChangeFilter
      • FleetInformation
      • VesselNavigationalStatusChangeFilter
      • FleetCompositionResponse
      • CompositionData
      • VesselInboundBaseResponse
      • Summary
      • TypeAndClass
      • RegistrationAndFlag
      • AnalyticsServiceCountryOfBuild
      • BuildAndOrigin
      • SizeAndDimensions
      • CategoryItem
      • ChartSection
      • RankedSection
      • BerthDetailQueryDto
      • SizeSection
      • DimensionsSection
      • AisGapStartedPosition
      • AisGapEndedPosition
      • ZoneCentroid
      • GapReportingMetaData
      • ZoneInformation
      • StsPairingServiceMeta
      • PscPortInformation
      • AisSpoofingMeta
      • FleetEventsResponse
      • PscInspectionServiceMetaData
      • FleetEventsData
      • ZoneServicePaginationMeta
      • EventVesselInformation
      • VesselInbound
      • ZoneEventDetails
      • ZoneEventResponse
      • Schedule
      • AisGapEventResponse
      • StsPairingEventResponse
      • StsPairedVessel
      • PositionalDiscrepancyEventResponse
      • Centroid
      • DiscrepancyPositionStart
      • DiscrepancyPositionEnd
      • PscEventResponse
      • BerthDetailResponseDto
      • GapEventsResponse
      • StsPairingsData
      • PscInspectionsResponse
      • Point
      • GapEventData
      • StsPairingEvent
      • PscInspectionData
      • LatestPosition
      • VesselScreening
      • GapEvent
      • Location
      • BerthKpiDto
      • FlagCodesDTO
      • PortInformation
      • BerthListMeta
      • GapPosition
      • StsPairingServiceVesselInformation
      • AnalyticsServiceNavigationalStatus
      • AisFieldDeltaVesselInformation
      • VesselStatus
      • GapReportingNavigationalStatus
      • StsPairingServiceErrorResponse
      • PscInspectionServiceVesselInformation
      • AisFieldDeltaMetaData
      • BerthListResponseDto
      • GapReportingVesselInformation
      • VesselSettingsRequestDto
      • LegacyMeta
      • PolygonDetails
      • PositionalDiscrepancyData
      • ZonePortSettingsRequestDto
      • FleetVesselListResponse
      • VesselFlag
      • LegacyStsPairingsData
      • PositionalDiscrepancyResponse
      • VesselSubscriptionRequestDTO
      • LegacyStsPairing
      • BerthTerminalGroupDto
      • ZoneServiceNavigationalStatus
      • ZonePortSubscriptionRequestDTO
      • LegacyPairedVessel
      • UpdateFleetV2Response
      • StsPairingServiceVesselCharacteristics
      • MaritimeAnalyticsBeErrorResponse
      • FleetSummaryV2
      • FleetDetailResponse
      • GapDto
      • StsPairingServiceDimensions
      • VesselIdentifiers
      • RejectedVessels
      • BerthInformation
      • VesselPositionsGroup
      • SubscriptionSingleResponseDTO
      • VesselResultsSummary
      • LatestVesselPositionItem
      • OccupancyPaginationDto
      • SubscriptionsResponseDTO
      • SubscriptionIdsRequestDTO
      • VesselEntryDetails
      • PortAnalyticsDataEntry
      • LatestPositionDetails
      • LatestPositionsResponse
      • FleetSummaryV2Update
      • PortAnalyticsMeta
      • VesselResultsDetail
      • ZonePortVessel
      • BerthEvent
      • VoyagePortCall
      • VoyagePortZoneEvent
      • PortDwellSeriesEntryDto
      • PortInfoDto
      • TopVesselDto
      • VesselVisitDto
      • ZoneAnalyticsDataEntry
      • ZoneAnalyticsMeta
      • ZoneAnalyticsTotals
      • ZoneInfoDto

    BerthDetailResponseDto

    Consolidated berth detail response containing all data for the berth detail page: berth details card, dwell time chart series, and vessel occupancy section.

    {
        "meta": {
            "request_id": "c2d3e4f5-a6b7-8901-cdef-bc2345678901",
            "request_timestamp": "2026-04-24T10:00:00+00:00"
        },
        "query": {
            "date_start": "2026-02-22",
            "date_end": "2026-03-23",
            "vessel_flags": [],
            "page": 1,
            "page_size": 14,
            "top_n": 10,
            "view_mode": "gantt",
            "dwell_series_granularity": "daily"
        },
        "berth_details": {
            "berth_id": "bb90f1f3-3590-4061-a40e-bda4d68bb449",
            "berth_name": "Berth C1",
            "berth_status": "Active",
            "terminal_operator": "Panama Ports Co.",
            "terminal_type": "Quay",
            "berth_facility": "FCL / LCL",
            "length_m": 350,
            "max_loa_m": 340,
            "max_dwt": 80000,
            "depth_lw_m": 13.5,
            "avg_dwell_time": 18.9,
            "median_dwell_time": 15.2
        },
        "dwell_time_series": [
            {
                "period_start": "2026-02-23",
                "avg_dwell_time": 19.1,
                "median_dwell_time": 15
            }
        ],
        "occupancy": {
            "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
                }
            ]
        }
    }
    Built with