Get overall scores for several vessels

Production

POST

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

Composite scores for up to 500 vessels in one call, without the category
breakdown. Same request shape as the detailed batch, and the same
notFound handling.

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 overall 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/overall/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": [
        {
            "imoNumber": "9999999",
            "mtiScore": 3.8,
            "mtiVesselClass": "Bulk Carriers",
            "updatedAt": "2026-09-29T02:00:00Z"
        }
    ],
    "notFound": [
        "9999990"
    ]
}

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

Get scores for several vessels

Get the score distribution for a vessel class