Vessel Search

Production

https://api.polestar-production.com

GET

/vessel-insights/v1/vessel-search

Search for any vessel by name, IMO number, MMSI number, Callsign or Pole
Star Asset ID.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Query Params

Responses

🟢200OK

application/json

A page of vessel summaries. meta.total_count is the number of matches
across the whole population, not the size of this page.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠414

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/vessel-insights/v1/vessel-search?asset_id=0ab8f38a-d723-475b-9505-acb844d9c96a&callsign=ZGDN9&imo=1010105&mmsi=319057800&name_contains=DOLCE&vessel_status_incl=Total%20Loss&vessel_status_excl=Total%20Loss&flag_code_incl=CYM&flag_code_excl=CYM&vessel_type_label_incl=Yacht&vessel_type_label_excl=Yacht&limit=100&offset=0' \
--header 'api-key: <api-key>'

Response Example

200 - A filter that matches one vessel

{
    "meta": {
        "limit": 100,
        "offset": 0,
        "request_id": "2b9d6c14-70af-4a35-b8ce-1d5e83f0a672",
        "request_timestamp": "2026-09-09T09:16:44.881Z",
        "total_count": 1
    },
    "data": [
        {
            "asset_id": "0ab8f38a-d723-475b-9505-acb844d9c96a",
            "callsign": "ZGDN9",
            "flag": "Cayman Islands",
            "flag_code": "CYM",
            "imo": "1010105",
            "mmsi": "319057800",
            "name": "DOLCE",
            "vessel_status": "Grounded",
            "vessel_type": "Yacht"
        }
    ]
}

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

Overview

Vessel Characteristics