Developer Portal
InsightsPurpleTRACMTI
Podium
Other
Other
  • Weather
InsightsPurpleTRACMTI
Podium
Other
Other
  • Weather
  1. Vessels
  • Start Here
    • Overview
    • Authentication
    • Understanding scores
    • Getting started
  • Vessels
    • List vessels
      GET
    • Get a vessel
      GET
  • MTI Scores
    • Get a vessel's scores
      GET
    • Get a vessel's overall score
      GET
    • Get scores for several vessels
      POST
    • Get overall scores for several vessels
      POST
    • Get the score distribution for a vessel class
      GET
  • Schemas
    • DetailMeta
    • ListMeta
    • ErrorResponse
    • VesselDetail
    • VesselScores
    • VesselOverallScore
    • VesselBatchItem
    • BatchScoresRequest
    • BatchMeta
  1. Vessels

Get a vessel

Production
Production
GET
/mti-api/api/v1/vessels/{imo}
One vessel by IMO number: identity, ownership, dimensions, management and
classification, alongside its MTI scores and the reason text behind each
category.
Use this when you want the full MTI record for a ship in one call. For
the numbers on their own, call the scores endpoints.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
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
or
Path Params

Responses

🟢200OK
application/json
Vessel detail with ship info and scores
Bodyapplication/json

🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠429
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/mti-api/api/v1/vessels/9811000' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - The full record for one vessel, for illustration
{
    "meta": {
        "requestId": "2c9d7e41-5b3a-4f86-9e0d-1a7b3c5e8f92",
        "requestTimestamp": "2026-09-30T09:30:00Z"
    },
    "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.",
        "createdAt": "2025-03-11T08:00:00Z",
        "updatedAt": "2026-09-29T02:00:00Z"
    }
}
Modified at 2026-10-06 09:29:59
Previous
List vessels
Next
Get a vessel's scores
Built with