Positional Discrepancies

Production

https://api.polestar-production.com

GET

/voyage-insights/v1/vessel-positional-discrepancy/{imo}

Retrieve a list of AIS positional discrepancy events for a single vessel
across a given time period.

Positional Discrepancies can be indicative of AIS Spoofing. This service
currently identifies the following common types of discrepancy events:

Same Position: The vessel transmits the exact same location for the
given time duration.

Bounding Box: The vessel transmits its location in a 50m x 50m area
for the given time duration.

Circle: The vessel transmits its location in a persistent circular
pattern for the given time duration.

MMSI Outlier: Outlier AIS positions have been detected during the
given time period, potentially indicating MMSI number spoofing.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Positional-discrepancy events for the vessel.

Headers

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/voyage-insights/v1/vessel-positional-discrepancy/9319466?timestamp_start=2024-03-01T00%3A00%3A00Z&timestamp_end=2024-03-27T09%3A00%3A00Z&event_types=SAME_POSITION&duration_hours_gte=6&offset=0&limit=100' \
--header 'api-key: <api-key>'

Response Example

200 - A single ended SAME_POSITION event

{
    "meta": {
        "limit": 100,
        "offset": 0,
        "request_id": "550e8400-e29b-41d4-a716-446655440000",
        "request_timestamp": "2024-03-27T09:00:00Z",
        "total_count": 1
    },
    "data": {
        "events": [
            {
                "has_ended": true,
                "duration_hours": 14,
                "event_type": "SAME_POSITION",
                "mmsi": "232003453",
                "started": {
                    "timestamp": "2024-03-04T11:15:00Z",
                    "draught": null,
                    "latitude": 51.9225,
                    "longitude": 4.47917,
                    "zones": [],
                    "ports": []
                },
                "stopped": {
                    "timestamp": "2024-03-05T01:20:00Z",
                    "draught": null,
                    "latitude": 51.9301,
                    "longitude": 4.48122,
                    "zones": [],
                    "ports": []
                }
            }
        ],
        "vessel_information": {
            "asset_id": "a3f1c2de-1b44-4c07-9f2e-6b1d0c7a55e1",
            "callsign": "PBEX",
            "flag": "Netherlands",
            "flag_code": "NLD",
            "imo": "9319466",
            "mmsi": "232003453",
            "name": "EXAMPLE TRADER",
            "vessel_type": "Chemical/Oil Products Tanker",
            "stat_code5": "A11A2T"
        }
    }
}

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

Vessel STS Pairings

Port State Control