3.2 Ship-to-Ship (STS) Events

Description

The Ship-to-Ship (STS) Events queries whether a specified vessel has had ship-to-ship (STS) operations within a specified time period. If STS events are detected, it will return details of the paired vessel, as well as the STS position, coordinates, start time and end time of the event.

Applicable Scenarios

Freight Logistics

Normal STS Transshipment
Monitor the cargo transfer flow where large vessels transship cargo to small crafts via STS operations. Track and analyze each phase of cargo circulation by combining the small craft details and their subsequent port berthing records.

Cargo Theft Monitoring
For non-transshipment scenarios, STS events detected during vessel navigation will trigger key monitoring for potential cargo theft. Determine whether small crafts are involved in cargo theft at the time of the STS event by integrating CCTV and other monitoring tools.

Maritime Supervision

Vessel Behavior Analysis
Maritime regulatory authorities can use vessel STS records to analyze vessel behavior patterns, and identify unauthorized STS operations as abnormal behaviors by combining other comprehensive datasets.

Request Limits

This is a premium service that requires advanced permission application prior to use.
An API key must be created before using this service.
Service calls are subject to quota restrictions according to your permission type.To view your current service access permissions or activate service permissions, please contact our support team: support@elaneglobal.com.

Endpoint

Endpoint	HTTP Method
`https://api.elaneglobal.com/v1/History/VesselStsEvents`	Get

Example API Call

https://api.elaneglobal.com/v1/History/VesselStsEvents?key=1F6D701272402D1E7D8D316CCE519123&mmsi=477172700&start_time=1749956794&end_time=1751446602&approach_zone=3

Note:
The key 1F6D701272402D1E7D8D316CCE519123 is the official key of elaneglobal.com, bound to the domain api.elaneglobal.com.
Users are not authorized to use this key for data access—utilizing it will return a status code 14, indicating an error in the source domain.
To trial the service, please contact our support team: support@elaneglobal.com.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

⚪0success

application/json

Body

Example

{
    "status": 0,
    "msg": "",
    "data": {
        "ship_data": {
            "mmsi": 477172700,
            "imo": 9783538,
            "call_sign": "VRRV4",
            "ship_name": "COSCO SHIPPING LIBRA",
            "ship_type": 70
        },
        "approach_data": [
            {
                "approach_ship": {
                    "mmsi": 477947300,
                    "imo": 9493107,
                    "call_sign": "VRKQ6",
                    "ship_name": "CSB HERALD",
                    "ship_type": 70
                },
                "approach_event": {
                    "approach_time": 1751260066,
                    "separation_time": 1751260429,
                    "duration": 6.05,
                    "approach_zone": 3,
                    "lat": 31.372347,
                    "lng": 121.689075,
                    "port_code": "",
                    "sog": 1.75
                }
            },
            {
                "approach_ship": {
                    "mmsi": 413372190,
                    "imo": 1400704,
                    "call_sign": "BPPZ",
                    "ship_name": "ZHONG HAI TUO 3",
                    "ship_type": 52
                },
                "approach_event": {
                    "approach_time": 1751260138,
                    "separation_time": 1751262848,
                    "duration": 45.17,
                    "approach_zone": 3,
                    "lat": 31.372347,
                    "lng": 121.689075,
                    "port_code": "",
                    "sog": 0.82
                }
            },
            {
                "approach_ship": {
                    "mmsi": 413377870,
                    "imo": 1400704,
                    "call_sign": "BPQJ",
                    "ship_name": "ZHONG HAI TUO 7",
                    "ship_type": 52
                },
                "approach_event": {
                    "approach_time": 1751260161,
                    "separation_time": 1751260467,
                    "duration": 5.1,
                    "approach_zone": 3,
                    "lat": 31.372347,
                    "lng": 121.689075,
                    "port_code": "",
                    "sog": 1.75
                }
            }
        ]
    }
}

3.2 Ship-to-Ship (STS) Events

Description#

Applicable Scenarios#

Request Limits#

Endpoint#

Example API Call#