Vessels in Zone or Port

Production

https://api.polestar-production.com

GET

/zone-port-insights/v1/vessels-in-zone-or-port/{id_type}/{id}

Returns the vessels inside one zone or port now, each with the time it entered, the position it entered at, and its latest known position.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Vessels in the zone or port. vessels is an empty array when none are inside; zone_port_information is still populated.

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/vessels-in-zone-or-port/ID/66a6d317-3f38-46c0-b46d-758d3a1ed385?offset=undefined&limit=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - Two of the vessels currently in Rotterdam

{
    "meta": {
        "limit": 2,
        "offset": 0,
        "total_count": 490,
        "request_id": "58b3791c-a4b1-431c-9ccf-c58ade4bcc8b",
        "request_timestamp": "2026-09-30T10:28:51Z",
        "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
        },
        "vessels": [
            {
                "timestamp_entered": "2026-09-30T09:46:23Z",
                "vessel_information": {
                    "asset_id": "c4a9a61b-f05e-4acf-99a9-4bc20103fb78",
                    "callsign": "PB8138",
                    "flag": "Netherlands",
                    "flag_code": "NLD",
                    "imo": "8336168",
                    "mmsi": "244810692",
                    "name": "AQUA LIGERA",
                    "vessel_type": "Oil (inland) tanker"
                },
                "entered_event_details": {
                    "latitude": 51.948383,
                    "longitude": 4.058005
                },
                "latest_position_details": {
                    "latitude": 51.948383,
                    "longitude": 4.058005
                }
            },
            {
                "timestamp_entered": "2026-09-30T09:46:13Z",
                "vessel_information": {
                    "asset_id": "724dc6e2-cf4d-4b66-ab43-26911177871f",
                    "callsign": "PF9298",
                    "flag": "Netherlands",
                    "flag_code": "NLD",
                    "imo": "8358415",
                    "mmsi": "244024014",
                    "name": "MADEGRO SR",
                    "vessel_type": "Dredger"
                },
                "entered_event_details": {
                    "latitude": 51.88479,
                    "longitude": 4.40682
                },
                "latest_position_details": {
                    "latitude": 51.88479,
                    "longitude": 4.40682
                }
            }
        ]
    }
}

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

Zone & Port Traffic

Zone & Port Notifications