Voyage Information

(VI01) Single Vessel Voyage Forecast

Get voyage information for a single vessel.

Notes

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
mmsi
required
integer

The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track

You can instead use imo or shipid

imo
integer

The International Maritime Organization (IMO) number of the vessel you wish to track

shipid
integer

A uniquely assigned ID by MarineTraffic for the subject vessel

msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
If used with the value extended, the response includes voyage related information (eg. distance travelled and to-go, load condition) and the estimated route to the vessel's destination
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    }
]

(VI01) Fleet Voyage Forecast

Get voyage information for one for your MarineTraffic Fleets.

Notes

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
fleet_id
required
integer

The fleet id you wish to receive voyage forecast for

msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
If used with the value extended, the response includes voyage related information (eg. distance travelled and to-go, load condition) and the estimated route to the vessel's destination
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    }
]

(VI04) Single Vessel Predictive Destinations

Receive a prediction of the likely destination of a single vessel.

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
mmsi
required
integer

The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track

You can instead use imo or shipid

imo
integer

The International Maritime Organization (IMO) number of the vessel you wish to track

shipid
integer

A uniquely assigned ID by MarineTraffic for the subject vessel

fromportid
integer

The MarineTraffic ID of the port you wish to receive a prediction (found on the URL of the respective Port page)

protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
[
  • {
    }
]

(VI04) Fleet Predictive Destinations

Receive a prediction of the likely destination for one of your MarineTraffic fleets.

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
fleet_id
required
integer

The MarineTraffic ID of the fleet you wish to track

fromportid
integer

The MarineTraffic ID of the port you wish to receive a prediction (found on the URL of the respective Port page)

protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
[
  • {
    }
]

(VI07) Vessel ETA to Port

Get ETA and voyage information for a vessel of your choice, to any port you define.

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

Version of the service to be executed. Use version 2 to get the latest

portid
required
integer

The MarineTraffic ID of the port you wish to receive ETA info

You can instead use unlocode

unlocode
string

The UN LOCODE (without gaps or spaces) of the port you wish to receive ETA info

mmsi
required
integer

The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track

You can instead use imo or shipid

imo
integer

The International Maritime Organization (IMO) number of the vessel you wish to track

shipid
integer

A uniquely assigned ID by MarineTraffic for the subject vessel

speed_calc
integer

The Speed of the Vessel that MarineTraffic will use to produce the ETA value

  • f not defined the last average speed of the Vessel will be used
  • if no average speed exists then a default value of 12(kn) will be used
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
If used with the value extended, the response includes voyage related data
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    }
]
➔ Next to Ports Information