Vessel Port Calls

Production

https://api.polestar-production.com

GET

/voyage-insights/v1/vessel-port-calls/{imo}

Get a list of port-area and port arrivals and departures, as well as
berth arrivals and departures, for a single vessel for a given time
period.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Port calls in the range. events is an empty array when none match; vessel_information is still populated for a known IMO.

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/voyage-insights/v1/vessel-port-calls/9345212?timestamp_start=2024-01-12T10%3A12%3A24&timestamp_end=2024-01-15T10%3A12%3A24&event_type=undefined&country_code=undefined&port_id=undefined&unlocode=undefined&sub_type=undefined&offset=undefined&limit=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - Two port calls for one vessel

{
    "meta": {
        "limit": 2,
        "offset": 0,
        "total_count": 1266,
        "request_id": "c702d7af-48ae-4c15-b7c8-8f5b542968ec",
        "request_timestamp": "2026-09-30T10:30:07Z",
        "zone_version": "0.8.2"
    },
    "data": {
        "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"
        },
        "events": [
            {
                "port_information": {
                    "centroid": {
                        "longitude": 4.187013817500381,
                        "latitude": 51.92554310489164
                    },
                    "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
                },
                "event_details": {
                    "course": 88.5,
                    "draught": 4.8,
                    "event_id": "4827d1e7-4f88-4d19-b788-7542976d1df6",
                    "event_timestamp": "2026-09-30T06:04:37Z",
                    "event_type": "BERTH_DEPARTURE",
                    "heading": 87,
                    "latitude": 51.89251,
                    "longitude": 4.317342,
                    "navigational_status": "Under way using engine",
                    "reported_destination": "RTM HARBOUR TOWAGE",
                    "reported_eta": "2026-10-15T20:00:00Z",
                    "speed": 8.8
                },
                "berth_information": {
                    "id": "ada97b9e-e463-4550-abc4-502a23dbcd88",
                    "name": "Vopak - Jetty No. 03"
                }
            },
            {
                "port_information": {
                    "centroid": {
                        "longitude": 4.187013817500381,
                        "latitude": 51.92554310489164
                    },
                    "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
                },
                "event_details": {
                    "course": 242.3,
                    "draught": 4.8,
                    "event_id": "175e441f-6a80-471c-8669-080509e746fd",
                    "event_timestamp": "2026-09-30T05:44:08Z",
                    "event_type": "BERTH_ARRIVAL",
                    "heading": 283,
                    "latitude": 51.876263,
                    "longitude": 4.2737293,
                    "navigational_status": "Under way using engine",
                    "reported_destination": "RTM HARBOUR TOWAGE",
                    "reported_eta": "2026-10-15T20:00:00Z",
                    "speed": 0
                },
                "berth_information": {
                    "id": "ada97b9e-e463-4550-abc4-502a23dbcd88",
                    "name": "Vopak - Jetty No. 03"
                }
            }
        ]
    }
}

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

Worked Examples

Vessel Zone & Port Events