Latest Vessel Positions

Production

https://api.polestar-production.com

POST

/meridia-voyage-intelligence/v1/latest

Returns the most recent consolidated position for each matching vessel.

This is a read that creates nothing. It is sent as a POST because the
filter (lists of IMO or MMSI numbers, or a circle or polygon geographic
filter) does not fit in a query string.

Requires at least one of vessel or geographic_filter. When vessel
is present, set exactly one of imo_numbers, mmsi_numbers or
fleet_id. fleet_id is currently rejected with 400 (ERROR_152):
fleet filtering is not supported yet, although the field is part of the
schema.

The server sets the lookback window, not the caller: 3 hours when a
geographic_filter is supplied, 31 days otherwise.

Paginated by limit and offset.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Latest position per matching vessel.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

cURL

Query by IMOsGeographical RectangleGeographical Circle

curl --location 'https://api.polestar-production.com/meridia-voyage-intelligence/v1/latest?limit=100&offset=0' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "vessel": {
        "imo_numbers": [
            "9749269",
            "9815733"
        ]
    }
}'

Response Example

200 - Query by IMOs

{
    "meta": {
        "limit": 100,
        "offset": 0,
        "request_id": "e9ac5f52-eec8-4c65-81c4-49bf3ee02879",
        "request_timestamp": "2026-07-16T08:57:23Z"
    },
    "data": [
        {
            "vessel": {
                "asset_id": "b2a9d7e1-6bd5-4781-ba91-9a09265a27e1",
                "mmsi": "525119001",
                "imo_number": 9815733,
                "name": "SABUK NUSANTARA 59",
                "call_sign": "YBNN2",
                "ship_type": "Passenger/General Cargo Ship",
                "flag": {
                    "name": "Indonesia",
                    "country_code": "IDN"
                }
            },
            "voyage_last_location": {
                "position_timestamp": "2026-07-16T08:55:36Z",
                "source": "T_AIS",
                "latitude": 1.1548433303833008,
                "longitude": 125.17044830322266,
                "speed": 9.8,
                "course": 353,
                "heading": 511,
                "navigational_status": {
                    "status": "Under way using engine",
                    "code": 1
                },
                "transceiver_class": "A",
                "raw_destination": "BITUNG",
                "matched_destination": {
                    "port_name": "Bitung",
                    "unlocode": "IDBIT",
                    "country": "Republic of Indonesia"
                },
                "eta": "2026-07-16T19:00:00Z",
                "draught": 0
            }
        },
        {
            "vessel": {
                "asset_id": "3d18e4d8-eae0-42fc-8d9f-7736ab343c1d",
                "mmsi": "538006864",
                "imo_number": 9749269,
                "name": "DSI AQUARIUS",
                "call_sign": "V7SH4",
                "ship_type": "Bulk Carrier",
                "flag": {
                    "name": "Marshall Islands",
                    "country_code": "MHL"
                }
            },
            "voyage_last_location": {
                "position_timestamp": "2026-07-16T08:46:30Z",
                "source": "PT_AIS",
                "latitude": 14.576231112368433,
                "longitude": -21.268417693487482,
                "speed": 10.3,
                "course": 25,
                "heading": 26,
                "navigational_status": {
                    "status": "Under way using engine",
                    "code": 1
                },
                "transceiver_class": "A",
                "raw_destination": "ES LPA",
                "matched_destination": {
                    "port_name": "Las Palmas De Gran Canaria",
                    "unlocode": "ESLPA",
                    "country": "Kingdom of Spain"
                },
                "eta": "2026-07-20T04:00:00Z",
                "draught": 11.3
            }
        }
    ]
}

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

Historical Vessel Track

Worked Examples