Zone & Port Traffic

Get a list of all vessels which have entered or exited a zone, or arrived
at or departed from the selected port and/or port area in a given time
period.

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

Zones:

Zone Entry: The vessel enters the zone

Zone Exit: The vessel exits the zone

Ports:

Port Area Arrival: The vessel enters the port area

Port Arrival: The vessel has stopped inside the port area

Port Departure: The vessel has started moving again inside the port
area

Port Area Departure: The vessel exits the port area

The response will contain a list of vessel events. Each event mentioned
above will generate a separate list entry. For each entry in the list,
two objects are returned:

Event Details: This contains the details of the associated event.

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

The response will also return details about the zone or port itself for
reference. zone_port_information is always populated when the id is
valid and visible to you, whether or not any event matches.

application/json

Traffic events in the range. events is an empty array when none match; zone_port_information is still populated.

Bodyapplication/json

curl --location 'https://api.polestar-production.com/zone-port-insights/v1/zone-and-port-traffic/ID/66a6d317-3f38-46c0-b46d-758d3a1ed385?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>'

{ "meta": { "limit": 2, "offset": 0, "total_count": 302, "request_id": "260c6e3e-7314-4033-8f8c-12ddd7f6043e", "request_timestamp": "2026-09-30T10:32:01Z", "zone_version": "0.8.2" }, "data": { "zone_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": [ { "vessel_information": { "asset_id": "e43dda59-5cfa-4bef-a7ab-26fae64b0dec", "callsign": "2GBH7", "flag": "United Kingdom", "flag_code": "GBR", "imo": "9518804", "mmsi": "235095972", "name": "STOLT SANDERLING", "vessel_type": "Chemical/Oil Products Tanker" }, "event_details": { "course": 32.9, "draught": 5.6, "event_id": "e5806a33-0e31-43cc-b6ff-286939a1eeb6", "event_timestamp": "2026-09-28T22:52:14Z", "event_type": "PORT_ARRIVAL", "heading": 35, "latitude": 51.88312, "longitude": 4.341355, "navigational_status": { "status": "Moored", "code": 6 }, "reported_destination": "NLRTM", "reported_eta": "2026-09-28T20:00:00Z", "speed": 0 } }, { "vessel_information": { "asset_id": "6100dc66-18ec-4556-9b34-7a37b0bd5c0b", "callsign": "5LUF7", "flag": "Liberia", "flag_code": "LBR", "imo": "9723241", "mmsi": "636024777", "name": "CZECH", "vessel_type": "Container Ship" }, "event_details": { "course": 306.3, "draught": 13, "event_id": "1be6703f-4c37-482e-95d5-6a696dc4f978", "event_timestamp": "2026-09-28T22:12:25Z", "event_type": "PORT_ARRIVAL", "heading": 263, "latitude": 51.960056, "longitude": 4.0651, "navigational_status": { "status": "Under way using engine", "code": 1 }, "reported_destination": "NLRTM", "reported_eta": "2026-09-28T19:45:00Z", "speed": 0.1 } } ] } }

Request

Responses