2.2 Currently Berthed Vessels

Description

The Currently Berthed Vessels retrieves information on all vessels currently berthed at a target port using the port’s five-digit port code. Returned data includes the total count of berthed vessels, vessel type, basic vessel details, port arrival time, and vessel dwell time.

Use Cases

Analyze the average patterns of vessel operation duration based on the dwell time of different vessel types in the returned dataset.

For logistic operations, filter vessels by type from the list of currently berthed vessels to identify suitable carriers for cargo transportation.

For vessel bunkering and marine equipment upgrade scenarios, obtain the list of in-port vessels first, then query vessel profiles to check equipment and other details, so as to identify targets eligible for bunkering services or equipment upgrade recommendations.

Request Limits

An API key must be created before using this service. API calls are subject to quota restrictions according to your permission type. To view your current service access permissions, please contact our support team: support@elaneglobal.com.

Endpoint

Endpoint	HTTP Method
`https://api.elaneglobal.com/v1/Voyage/PortBerthedVessels`	GET

Example API Call

https://api.elaneglobal.com/v1/Voyage/PortBerthedVessels?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG

Note:
The key 1F6D701272402D1E7D8D316CCE519123 is the official key of Shipfinder.com, bound to the domain api.shipfinder.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 create your own key in the Dashboard.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

Example

{
  "status": 0,
  "msg": "",
  "total": 713,
  "data": [
    {
      "mmsi": 100900006,
      "imo": 0,
      "call_sign": "YYYY",
      "ship_name": "AISTESTSHIP",
      "ship_type": 70,
      "length": 50,
      "width": 6,
      "left": 5,
      "trail": 10,
      "draught": 0,
      "arrival_time": "1746484554",
      "stay_time": 2166.2
    },
    {
      "mmsi": 100900100,
      "imo": 0,
      "call_sign": "YYYY",
      "ship_name": "AISTESTSHIP",
      "ship_type": 70,
      "length": 50,
      "width": 6,
      "left": 5,
      "trail": 10,
      "draught": 0,
      "arrival_time": "1746609269",
      "stay_time": 87.7
    },
    ........
  ]
}

2.2 Currently Berthed Vessels

Description#

Use Cases#

Request Limits#

Endpoint#

Example API Call#