Vessel STS Pairings

Production

https://api.polestar-production.com

GET

/voyage-insights/v1/vessel-sts-pairings/{imo}

Get a vessel's Ship to Ship Pairings for a given time period. The pairing
type and duration threshold are configurable.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

STS pairings for the vessel within the window

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠405

🟠422Parameter Error

🟠429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/voyage-insights/v1/vessel-sts-pairings/8505549?timestamp_start=2021-05-19T07%3A24%3A15Z&timestamp_end=2021-05-25T05%3A25%3A15Z&sts_type=Cargo&sts_duration_gte=6&limit=100&offset=0' \
--header 'api-key: <api-key>'

Response Example

200 - One Cargo pairing found

{
    "meta": {
        "limit": 100,
        "offset": 0,
        "request_id": "6f1c1b2e-9f6d-4a3e-8f21-0d3f5f2b7a10",
        "request_timestamp": "2021-05-26T10:15:30Z",
        "total_count": 1
    },
    "data": {
        "vessel_information": {
            "asset_id": "0000",
            "callsign": "ZGDN9",
            "flag": "Cayman Islands",
            "flag_code": "CYM",
            "imo": "8505549",
            "mmsi": "319057800",
            "name": "DOLCE",
            "vessel_type": "Yacht"
        },
        "events": [
            {
                "started": "2021-05-20T16:06:20Z",
                "stopped": "2021-05-24T16:06:20Z",
                "duration_hours": 96,
                "sts_type": "Cargo",
                "location": {
                    "latitude": 52.413483,
                    "longitude": 4.7480984
                },
                "paired_vessel": {
                    "asset_id": "0000",
                    "callsign": "ZGDN9",
                    "flag": "Cayman Islands",
                    "flag_code": "CYM",
                    "imo": "9936238",
                    "mmsi": "319057800",
                    "name": "DOLCE",
                    "vessel_type": "Yacht"
                }
            }
        ]
    }
}

Modified at 2026-10-06 09:29:43

Vessel AIS Reporting Gaps

Positional Discrepancies