List Fleet Vessels

Production

https://api.polestar-production.com

GET

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

Retrieves the vessels in one of your fleets, with pagination, filtering, and sorting so you can browse large fleets and find the vessels you need. Only fleets created by your account can be accessed, and requests are authenticated with your API key in the API-KEY header. The mti_score property is included for each vessel only if your account is entitled to the MTI tier-1 feature; otherwise it is omitted.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Successfully retrieved vessels list.

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/vessels?limit=undefined&offset=undefined&sort_by=undefined&flag_code=undefined&vessel_type=undefined&vessel_class=undefined&mti_score=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - The two vessels in the fleet, with their latest positions

{
    "meta": {
        "request_id": "550e8400-e29b-41d4-a716-446655440000",
        "request_timestamp": "2026-09-08T10:15:30Z",
        "limit": 50,
        "offset": 0,
        "total_count": 2
    },
    "fleet_information": {
        "fleet_id": "f162c3c2-cce3-4857-81a2-093dd3b50bcb",
        "name": "Rotterdam Arrivals Watch",
        "vessel_count": 2
    },
    "data": [
        {
            "vessel_information": {
                "imo": "9518804",
                "mmsi": "235095972",
                "name": "STOLT SANDERLING",
                "callsign": "2GBH7",
                "flag": "United Kingdom",
                "flag_code": "GBR",
                "vessel_type": "Chemical/Oil Products Tanker",
                "vessel_status": "In Service/Commission",
                "build_year": 2011,
                "age": 15,
                "deadweight": 4453
            },
            "vessel_position": {
                "latitude": 51.88312,
                "longitude": 4.341355,
                "course": 32.9,
                "heading": 35,
                "speed": 0,
                "navigational_status": {
                    "status": "Moored",
                    "code": 6
                },
                "draught": 5.6,
                "reported_destination": "NLRTM",
                "reported_eta": "2026-09-28T20:00:00Z",
                "timestamp": "2026-09-28T22:52:14Z",
                "source": "AIS"
            },
            "added_at": "2026-09-07T08:00:00Z",
            "added_by": "j.harding@example.com"
        },
        {
            "vessel_information": {
                "imo": "9723241",
                "mmsi": "636024777",
                "name": "CZECH",
                "callsign": "5LUF7",
                "flag": "Liberia",
                "flag_code": "LBR",
                "vessel_type": "Container Ship",
                "vessel_status": "In Service/Commission",
                "build_year": 2015,
                "age": 11,
                "deadweight": 111530
            },
            "vessel_position": {
                "latitude": 51.960056,
                "longitude": 4.0651,
                "course": 306.3,
                "heading": 263,
                "speed": 0.1,
                "navigational_status": {
                    "status": "Under way using engine",
                    "code": 1
                },
                "draught": 13,
                "reported_destination": "NLRTM",
                "reported_eta": "2026-09-28T19:45:00Z",
                "timestamp": "2026-09-28T22:12:25Z",
                "source": "AIS"
            },
            "added_at": "2026-09-08T10:15:30Z",
            "added_by": "j.harding@example.com"
        }
    ]
}

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

Update Fleet

Get Fleet Composition