List vessels

Production

GET

/mti-api/api/v1/vessels

Every vessel we score, filtered on flag, type, status and score range.
Sort with sort_by, and page with limit and offset.

Each row carries the vessel record and its five category scores, so one
call is usually enough to build a fleet table.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://auth.mti.stage.polestardefense.com/realms/mti-stage/protocol/openid-connect/token

Query Params

Responses

🟢200OK

application/json

Paginated list of vessels with ship info and scores

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/mti-api/api/v1/vessels?limit=undefined&offset=undefined&search=undefined&flag_country=undefined&vessel_type=undefined&vessel_status=undefined&score_min=undefined&score_max=undefined&sort_by=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - One vessel, for illustration

{
    "meta": {
        "requestId": "2c9d7e41-5b3a-4f86-9e0d-1a7b3c5e8f92",
        "requestTimestamp": "2026-09-30T09:30:00Z",
        "limit": 20,
        "offset": 0,
        "totalCount": 1
    },
    "data": [
        {
            "id": 48213,
            "imoNumber": "9999999",
            "vesselName": "EXAMPLE TRADER",
            "mmsi": "999999999",
            "flagCountry": "Liberia",
            "portOfRegistry": "Monrovia",
            "vesselType": "Bulk Carrier",
            "vesselStatus": "In Service/Commission",
            "buildYear": 2012,
            "countryOfBuild": "China",
            "shipBuilder": "Example Shipyard",
            "grossTonnage": 43012,
            "deadweight": 81600,
            "length": 229,
            "breadth": 32.3,
            "groupBeneficialOwner": "Example Holdings",
            "operationsManager": "Example Ship Management",
            "shipManager": "Example Ship Management",
            "technicalManager": "Example Technical Services",
            "registeredOwner": "Example Trader Shipping Inc",
            "classificationSociety": "Det Norske Veritas (IACS)",
            "pandiClub": "Example P&I Club",
            "summary": "A mid-life bulk carrier with a stable ownership history and good AIS reporting. No current sanctions association.",
            "mtiScore": 3.8,
            "vesselScore": 4.1,
            "reportingScore": 3.2,
            "voyagesScore": 3.9,
            "emissionsScore": 3.5,
            "sanctionsScore": 4.6,
            "mtiVesselClass": "Bulk Carriers",
            "vesselReason": "No detentions in the last three years and no flag or name changes since 2019.",
            "reportingReason": "Two AIS reporting gaps over twelve hours in the last twelve months.",
            "voyagesReason": "Occasional calls in higher risk zones, with no ship to ship transfers recorded there.",
            "sanctionsReason": "No association with a current designation.",
            "emissionsReason": "Estimated CO2 output slightly above the CII reference for its class."
        }
    ]
}

Modified at 2026-09-30 12:28:23

Getting started

Get a vessel