AIS positional discrepancy (spoofing) events

Production

https://api.polestar-production.com

GET

/purpletrac/v1/positionaldiscrepancy

Retrieves AIS positional discrepancy ("spoofing") events detected for a transaction: e.g. two vessels reporting the same position, box-shaped or circular movement patterns, or MMSI outliers, including the zones and ports involved at the start and stop of the event.

Positional discrepancy checks are feature-gated per event_type on the account. The endpoint itself has no feature/404 gate; if expected data is missing, confirm the relevant detection feature is enabled for the account.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

Query Params

Responses

🟢200OK

application/json

AIS positional discrepancy events, where the vessel's reported position conflicts with other evidence of where it was.

Headers

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/purpletrac/v1/positionaldiscrepancy?username=undefined&limit=undefined&offset=undefined&order_by=undefined&transaction_id=undefined&api_key=%3Capi-key%3E'

Response Example

200 - Default

{
    "meta": {
        "limit": 20,
        "next": null,
        "offset": 0,
        "previous": null,
        "total_count": 1
    },
    "objects": [
        {
            "id": 9021,
            "transaction_id": 2840116,
            "event_type": "SAME_POSITION",
            "mmsi": "367594740",
            "duration_hours": 24,
            "start_latitude": 1.264,
            "start_longitude": 104,
            "start_draught": 12.5,
            "start_timestamp": "2026-05-01T02:15:00",
            "stop_latitude": 1.3,
            "stop_longitude": 104.1,
            "stop_draught": 12.5,
            "stop_timestamp": "2026-05-01T05:45:00",
            "severity": "WARNING",
            "overall_severity": "WARNING",
            "start_zones": [
                {
                    "zone_id": 12,
                    "zone_name": "Piracy High Risk Area",
                    "severity": "WARNING"
                }
            ],
            "stop_zones": [],
            "start_ports": [],
            "stop_ports": [
                {
                    "name": "Singapore",
                    "country_name": "Singapore",
                    "unlocode": "SGSIN",
                    "severity": "OK"
                }
            ]
        }
    ]
}

Modified at 2026-09-18 08:35:54

Flag history check

Periods of Non-Reporting