Berth Calls by Port

Production

https://api.polestar-production.com

GET

/zone-port-insights/v1/port-berth-traffic/{id_type}/{id}

Get a list of all berth arrival and departure events for vessels at the
selected port within a given time period.

For each vessel the following events can be returned in the response:

Berth Arrival: The vessel arrives at a specific berth within the
port

Berth Departure: The vessel departs from a specific berth within
the port

The response will contain a list of berth events. Each event will
generate a separate list entry. For each entry in the list, three objects
are returned:

Event Details: This contains the details of the associated berth event
including position, timestamp, and navigational data.

Vessel Information: Basic vessel information like name, type, IMO
Number, MMSI number, etc.

Berth Information: Details about the specific berth including the berth
id, name, and associated port id.

The response will also return details about the port itself for
reference.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

api-key: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Berth events in the range. events is an empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/zone-port-insights/v1/port-berth-traffic/ID/4770?event_type=undefined&timestamp_start=2024-01-12T10%3A12%3A24&timestamp_end=2024-01-15T10%3A12%3A24&offset=undefined&limit=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - Berth events in Rotterdam on 28 September 2026

{
    "meta": {
        "limit": 2,
        "offset": 0,
        "total_count": 565,
        "request_id": "158452e4-507c-4355-ac68-62a398789631",
        "request_timestamp": "2026-09-30T10:28:52Z",
        "zone_version": "0.8.2"
    },
    "data": {
        "port_information": [
            {
                "centroid": {
                    "longitude": 4.187014,
                    "latitude": 51.925543
                },
                "country_official_name": "Kingdom of the Netherlands",
                "country_code": "NLD",
                "description": "",
                "id": "c750eef6-52c0-4c96-9def-90f7eb8914b4",
                "name": "Rotterdam",
                "sub_type": "Port",
                "type": "Ports",
                "unlocode": "NLRTM",
                "country_common_name": "Netherlands",
                "sub_division_code": "NL-ZH",
                "sub_division_name": "Zuid-Holland",
                "wpi_number": 31140
            }
        ],
        "events": [
            {
                "event_details": {
                    "course": 83.8,
                    "draught": 4.8,
                    "event_id": "9f851b3d-a56a-4264-9357-38d46e884c75",
                    "event_timestamp": "2026-09-28T23:58:49Z",
                    "event_type": "BERTH_DEPARTURE",
                    "heading": 83,
                    "latitude": 51.883705,
                    "longitude": 4.2815046,
                    "navigational_status": {
                        "status": "Under way using engine",
                        "code": 1
                    },
                    "reported_destination": "RTM HARBOUR TOWAGE",
                    "reported_eta": "2026-10-15T20:00:00Z",
                    "speed": 3.7
                },
                "vessel_information": {
                    "asset_id": "8dd25ab2-3948-4585-b7c5-8d3b2faf468b",
                    "callsign": "CQ2111",
                    "flag": "Portugal (Mar)",
                    "flag_code": "PRT",
                    "imo": "9765043",
                    "mmsi": "255915653",
                    "name": "FAIRPLAY-28",
                    "vessel_type": "Tug"
                },
                "berth_information": {
                    "id": "a4d22678-7fa0-45d6-8e95-29240732839d",
                    "name": "No 53",
                    "port_id": "c750eef6-52c0-4c96-9def-90f7eb8914b4"
                }
            },
            {
                "event_details": {
                    "course": 100.4,
                    "draught": 5.4,
                    "event_id": "99d07b81-9f97-49dd-9091-33cd1a63bfe6",
                    "event_timestamp": "2026-09-28T23:57:05Z",
                    "event_type": "BERTH_DEPARTURE",
                    "heading": 279,
                    "latitude": 51.893745,
                    "longitude": 4.3095274,
                    "navigational_status": {
                        "status": "Under way using engine",
                        "code": 1
                    },
                    "reported_destination": "HARBOURTOWAGE",
                    "reported_eta": "2027-03-09T22:00:00Z",
                    "speed": 6.5
                },
                "vessel_information": {
                    "asset_id": "4660b569-78b5-4288-a4d2-1cc9a6a9a600",
                    "callsign": "PHXY",
                    "flag": "Netherlands",
                    "flag_code": "NLD",
                    "imo": "9060699",
                    "mmsi": "245907000",
                    "name": "VB TEXELBANK",
                    "vessel_type": "Tug"
                },
                "berth_information": {
                    "id": "a6ad26a3-00b5-4b09-8f44-83449f2973aa",
                    "name": "No 59",
                    "port_id": "c750eef6-52c0-4c96-9def-90f7eb8914b4"
                }
            }
        ]
    }
}

Modified at 2026-10-21 13:57:11

Port Insights

Inbound Vessels