Get scores for several vessels

Production

POST

/mti-api/api/v1/vessels/scores/batch

Category scores for up to 500 vessels in one call. Post the IMO numbers
you want in imos.

We return what we hold in data and list anything we do not recognise in
notFound, so one bad IMO number does not fail the whole request.

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

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Batch scores with found data and notFound IMOs

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/mti-api/api/v1/vessels/scores/batch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "imos": [
        "string"
    ]
}'

Response Example

200 - Two IMO numbers requested, one scored, for illustration

{
    "meta": {
        "requestId": "2c9d7e41-5b3a-4f86-9e0d-1a7b3c5e8f92",
        "requestTimestamp": "2026-09-30T09:30:00Z",
        "requestedCount": 2,
        "returnedCount": 1
    },
    "data": [
        {
            "imo_number": "9999999",
            "vessel_name": "EXAMPLE TRADER",
            "mmsi": "999999999",
            "flag_country": "Liberia",
            "vessel_type": "Bulk Carrier",
            "vessel_status": "In Service/Commission",
            "mti_score": 3.8,
            "mti_vessel_class": "Bulk Carriers",
            "updated_at": "2026-09-29T02:00:00Z",
            "scores": {
                "vessel_score": 4.1,
                "reporting_score": 3.2,
                "voyages_score": 3.9,
                "sanctions_score": 4.6,
                "emissions_score": 3.5
            }
        }
    ],
    "notFound": [
        "9999990"
    ]
}

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

Get a vessel's overall score

Get overall scores for several vessels