3.6 Port Calls Records for Port

Description

This Port Calls Records for Port service retrieves all vessels that have called at a port within a specified time frame by the port’s 5-digit port code. Returned data includes vessel basic details, port call records at the target port, and the corresponding previous/next port of call records for each vessel.

Use Cases

Logistics Tracking
Query and analyze the number of calling vessels, their berth distribution and port call time windows at a port during a specified period. Filter and aggregate the average vessel waiting time and operating time by vessel category, and estimate vessel queuing time at the port as a reference for overall voyage timeline calculation.

Port Analytics

Request Limits

An API key must be created before using this service.
Service calls are subject to quota restrictions according to your permission type.
This service queries port call records within the latest month by default. To view your current service access permissions or enable the query for port call records covering 6 months, 12 months or a longer period, please contact our support team: support@elaneglobal.com.

Endpoint

Endpoint	HTTP Method
`https://api.elaneglobal.com/v1/History/PortCallRecordsByPort`	GET

Example API Call

[https://api.elaneglobal.com/v1/History/PortCallRecordsByPort?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG&start_time=1744467589&end_time=1744967589]

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": "",
  "total": 5140,
  "data": [
    {
      "imo": 0,
      "mmsi": 413842124,
      "ship_type": "70",
      "ship_name": "ZHEJIAXINGHUO03191",
      "call_sign": "0",
      "currentport": {
        "port_code": "27999",
        "port_cnname": "上海",
        "port_name": "Shanghai",
        "port_time_zone": "+8",
        "terminal_name": "",
        "berth_name": "",
        "arrival_anchorage": ,
        "ata": 1744468393,
        "atb": 1744468393,
        "atd": 1744635846,
        "arrival_draught": 0,
        "departure_draught": 0,
        "stay_time": 46.51,
        "stay_terminal_time": 46.51
      },
      "previousport": {
        "port_code": "27999",
        "port_cnname": "上海",
        "port_name": "Shanghai",
        "port_time_zone": "+8",
        "arrival_anchorage": "",
        "ata": 1744110014,
        "atb": 1744110014,
        "atd": 1744120857
      },
      "nextport": {
        "port_code": "213479",
        "port_cnname": "奉贤",
        "port_name": "Fengxian",
        "port_time_zone": "+8",
        "arrival_anchorage": "",
        "ata": 1744484085,
        "atb": 1744484085,
        "atd": 1744498411
      }
    },
    {
      "imo": 9302530,
      "mmsi": 412046070,
      "ship_type": "90",
      "ship_name": "HU JIU 18",
      "call_sign": "BSAR",
      "currentport": {
        "port_code": "27999",
        "port_cnname": "上海",
        "port_name": "Shanghai",
        "port_time_zone": "+8",
        "terminal_name": "Eastern Tankstore Shanghai",
        "berth_name": "No 2",
        "arrival_anchorage": "",
        "ata": 1744469305,
        "atb": 1744469305,
        "atd": 1745489204,
        "arrival_draught": 3500,
        "departure_draught": 3500,
        "stay_time": 283.31,
        "stay_terminal_time": 283.31
      },
      "previousport": {
        "port_code": "213784",
        "port_cnname": "崇明",
        "port_name": "Chongming",
        "port_time_zone": "+8",
        "arrival_anchorage": "",
        "ata": 1744469305,
        "atb": 1744469305,
        "atd": 1745489204
      },
      "nextport": {
        "port_code": "213784",
        "port_cnname": "崇明",
        "port_name": "Chongming",
        "port_time_zone": "+8",
        "arrival_anchorage": "",
        "ata": 1744469305,
        "atb": 1744469305,
        "atd": 1745489204
      }
    },
    ......
  ]
}

3.6 Port Calls Records for Port

Description#

Use Cases#

Request Limits#

Endpoint#

Example API Call#