List Fleet Events

Production

https://api.polestar-production.com

GET

/fleet-management/v2/fleets/{fleet_id}/events

List recent events across every vessel in a fleet, most useful for a
fleet-wide activity feed.

timestamp_start is required; timestamp_end is optional. Both are UTC,
ISO 8601, and inclusive. Narrow the feed with event_type, repeating the
parameter or giving a comma-separated list:

ZONE_ENTRY, ZONE_EXIT, PORT_ARRIVAL, PORT_DEPARTURE,
PORT_AREA_ARRIVAL, PORT_AREA_DEPARTURE: zone and port activity.

AIS_GAP: periods when a vessel stopped transmitting AIS.

STS_PAIRING: potential ship-to-ship operations.

POSITIONAL_DISCREPANCY: possible AIS spoofing.

PORT_STATE_CONTROL: inspections and detentions.

Each entry in data.events carries event_details, whose fields depend
on the event type, and the vessel's vessel_information; zone and port
events also carry zone_information. Page with limit (1 to 500,
default 100) and offset. Only the user who created the fleet can read
its events.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Successfully retrieved recent fleet events.

Headers

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/fleet-management/v2/fleets/f162c3c2-cce3-4857-81a2-093dd3b50bcb/events?event_type=AIS_GAP&event_type=ZONE_ENTRY&limit=100&offset=0&timestamp_start=2026-09-01T00%3A00%3A00Z&timestamp_end=2026-09-08T00%3A00%3A00Z' \
--header 'api-key: <api-key>'

Response Example

200 - Zone entry event

{
    "meta": {
        "request_id": "266ea41d-adf5-480b-af50-15b940c2b846",
        "request_timestamp": "2026-09-08T10:15:30Z",
        "limit": 100,
        "offset": 0,
        "total_count": 1
    },
    "data": {
        "events": [
            {
                "event_details": {
                    "event_id": "6f0c7d3a-1d2e-4f8a-9b5c-2a7e6d1f0041",
                    "event_type": "ZONE_ENTRY",
                    "event_timestamp": "2026-09-08T09:45:00Z",
                    "course": 182.5,
                    "draught": 7.2,
                    "heading": 180,
                    "navigational_status": {
                        "status": "Under way using engine",
                        "code": "0"
                    },
                    "reported_destination": "NLRTM",
                    "reported_eta": "2026-09-09T06:00:00Z",
                    "speed": 12.4,
                    "zone_port_event_location": {
                        "longitude": 4.1256,
                        "latitude": 51.9852
                    }
                },
                "zone_information": {
                    "centroid": {
                        "longitude": 4.1256,
                        "latitude": 51.9852
                    },
                    "country_official_name": "Kingdom of the Netherlands",
                    "country_code": "NLD",
                    "description": "Rotterdam anchorage area",
                    "id": "4e7a2c91-6b3d-4f80-9a15-c8d2e6b74011",
                    "name": "Rotterdam Anchorage",
                    "sub_type": "Anchorage",
                    "type": "Maritime Zone",
                    "unlocode": "NLRTM",
                    "country_common_name": "Netherlands",
                    "sub_division_code": "ZH",
                    "sub_division_name": "Zuid-Holland",
                    "wpi_number": "12345"
                },
                "vessel_information": {
                    "asset_id": "8b7c6d5e-4f3a-4210-9b8c-7d6e5f4a3210",
                    "callsign": "PCAB",
                    "imo": "9226956",
                    "mmsi": "244123456",
                    "name": "OCEAN BULK CARRIER",
                    "flag_code": "NLD",
                    "flag": "Netherlands",
                    "vessel_type": "Bulk Carrier"
                }
            }
        ]
    }
}

Modified at 2026-10-21 13:49:55

Get Fleet Composition

Custom Zones