2.4 Inbound / Expected Arrivals

Description

The Inbound/Expected Arrivals retrieves the list and detailed information of vessels expected to arrive at a target port within a specified future time period, using the port’s five-digit port code and the query time period.

Use Cases

Maritime Supervision
Filter vessels by type and flag state based on the inbound vessel schedule for a specified future period. It allows advance allocation of customs or border inspection resources, and supports risk vessel analysis by combining historical abnormal AIS events, vessel alongside records and other relevant information.

Logistics Vessel Sourcing
Filter the list of inbound cargo vessels at ports near the shipping warehouse, and launch cargo booking solicitations by referring to the operating company information in vessel profiles or the vessel contact list maintained in the corporate shipping capacity pool.

Maritime Traffic Analysis
Analyze port carrying capacity and the attribute profiles of all inbound vessels scheduled to arrive at the port.

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/Voyage/PortExpectedArrivals`	Get

Example API Call

https://api.elaneglobal.com/v1/Voyage/PortExpectedArrivals?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG&start_time=1746612218&end_time=1747044218&ship_type=0

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 Parameters

Parameter	Legend	Type	Required	Description
key	Authorization Code	string	yes	Your personal Shipfinder API key to verify service permissions
port_code	Standard Port Code	string	yes	Standard five-digit port code
start_time	Start Time	int	yes	Start time represented as a UTC timestamp. The start time must be later than the current time.
end_time	End Time	int	yes	End time represented as a UTC timestamp. The interval between the start time and end time shall not exceed 1 week for a single request.
ship_type	Ship Type	int	no	Filter the type of vessels: see References for details. All vessels will be returned if this parameter is not specified.

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": 1,
  "data": [
    {
      "mmsi": 760004503,
      "ship_name": "TINO 3",
      "imo": 0,
      "dwt": 0,
      "ship_type": 0,
      "length": 12,
      "width": 33,
      "draught": 5.7,
      "preport_name": "Manzanillo",
      "last_time": 1774921277,
      "eta": 1775100580,
      "dest": "Callao",
      "ship_flag": "Peru"
    }
  ]
}

2.4 Inbound / Expected Arrivals

Description#

Use Cases#

Request Limits#

Endpoint#

Example API Call#

Request Parameters#

Request