Vessel Zone & Port Events

Production

https://api.polestar-production.com

GET

/voyage-insights/v1/vessel-zone-and-port-events/{imo}

Get a list of all zone entries and exits and port call events 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

Zone and port events 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-zone-and-port-events/9345212?country_code=undefined&event_type=undefined&id=undefined&sub_type=undefined&types=undefined&unlocode=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 - Two zone and port events for one vessel

{
    "meta": {
        "limit": 2,
        "offset": 0,
        "total_count": 444,
        "request_id": "7bb216a2-678a-4e7c-a1b7-4ccd0ea47b5f",
        "request_timestamp": "2026-09-30T10:30:08Z",
        "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": [
            {
                "zone_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": 286.6,
                    "draught": 4.8,
                    "event_id": "e6dc56fa-0079-4583-8c8b-540970020d70",
                    "event_timestamp": "2026-09-30T06:44:54Z",
                    "event_type": "PORT_ARRIVAL",
                    "heading": 33,
                    "latitude": 51.911484,
                    "longitude": 4.423234,
                    "navigational_status": "Under way using engine",
                    "reported_destination": "RTM HARBOUR TOWAGE",
                    "reported_eta": "2026-10-15T20:00:00Z",
                    "speed": 0
                }
            },
            {
                "zone_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": 286.6,
                    "draught": 4.8,
                    "event_id": "fa017306-97d3-4ae1-bc08-ae3c5ca850ba",
                    "event_timestamp": "2026-09-30T06:44:54Z",
                    "event_type": "PORT_AREA_ARRIVAL",
                    "heading": 33,
                    "latitude": 51.911484,
                    "longitude": 4.423234,
                    "navigational_status": "Under way using engine",
                    "reported_destination": "RTM HARBOUR TOWAGE",
                    "reported_eta": "2026-10-15T20:00:00Z",
                    "speed": 0
                }
            }
        ]
    }
}

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

Vessel Port Calls

Vessel AIS Reporting Gaps