Ship-to-Ship (STS) pairing screening

Production

https://api.polestar-production.com

GET

/purpletrac/v1/stspairing

Retrieves Ship-to-Ship (STS) pairing screening results for a transaction: vessels that came alongside the screened vessel, where and when the pairing occurred, its duration, and any matched high-risk zones.

Requires the optional STS_PAIRING feature to be enabled for the account. If it is not enabled the endpoint returns 404 regardless of the data present.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

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

Query Params

Responses

🟢200OK

application/json

Ship-to-ship pairing events detected for the vessel, with the counterparty and its screening result.

Headers

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/purpletrac/v1/stspairing?username=undefined&limit=undefined&offset=undefined&order_by=undefined&screenresult=undefined&started_at__gte=undefined&started_at__lte=undefined&vessel_type=undefined&sts_type=undefined&sts_location=undefined&sts_country=undefined&sts_vessel_flag=undefined&matched_zones=undefined&duration__gte=undefined&duration__lte=undefined&api_key=%3Capi-key%3E'

Response Example

200 - Default

{
    "meta": {
        "limit": 20,
        "next": null,
        "offset": 0,
        "previous": null,
        "total_count": 1
    },
    "objects": [
        {
            "id": 4521,
            "screenresult": "/api/v1/screenresult/2840116",
            "imo_number": "9183934",
            "vessel_name": "OCEAN STAR",
            "vessel_type": "Tanker",
            "sts_type": "Ship to Ship",
            "sts_location": "Off Malaysia",
            "sts_country": "Malaysia",
            "sts_country_severity": "OK",
            "sts_zones_severity": "CRITICAL",
            "sts_overall_severity": "WARNING",
            "screening_severity": "OK",
            "sts_vessel_flag": "Panama",
            "latitude": 1.264,
            "longitude": 104,
            "started_at": "2026-05-01T02:15:00",
            "ended_at": "2026-05-01T05:45:00",
            "duration_seconds": 12600,
            "zones": [
                {
                    "zone_name": "Piracy High Risk Area",
                    "severity": "CRITICAL"
                }
            ]
        }
    ]
}

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

Ship movement history

Company history check