Voyage Information

Single Vessel Voyage Forecast

Get voyage information for a single vessel.

Notes

Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

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
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 jsono

Responses

Response samples

200
400
429

Content type

Example

[{"MMSI": "310627000",
"IMO": "9241061",
"SHIP_ID": "371681",
"SHIPNAME": "QUEEN MARY 2",
"DESTINATION": "TORQUAY",
"LAST_PORT_ID": "106",
"LAST_PORT": "SOUTHAMPTON",
"LAST_PORT_UNLOCODE": "GBSOU",
"LAST_PORT_TIME": "2020-10-14T17:00:00.000Z",
"NEXT_PORT_ID": "10379",
"NEXT_PORT_NAME": "TORQUAY",
"NEXT_PORT_UNLOCODE": "GBTOR",
"ETA": "2020-10-14T13:00:00.000Z",
"ETA_CALC": ""
}
]

Fleet Voyage Forecast

Get voyage information for one for your MarineTraffic Fleets.

Notes

Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

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
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 jsono

Responses

Response samples

200
404
429

Content type

Example

[{"MMSI": "310627000",
"IMO": "9241061",
"SHIP_ID": "371681",
"SHIPNAME": "QUEEN MARY 2",
"DESTINATION": "TORQUAY",
"LAST_PORT_ID": "106",
"LAST_PORT": "SOUTHAMPTON",
"LAST_PORT_UNLOCODE": "GBSOU",
"LAST_PORT_TIME": "2020-10-14T17:00:00.000Z",
"NEXT_PORT_ID": "10379",
"NEXT_PORT_NAME": "TORQUAY",
"NEXT_PORT_UNLOCODE": "GBTOR",
"ETA": "2020-10-14T13:00:00.000Z",
"ETA_CALC": ""
}
]

Single Vessel Predictive Destinations

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

Notes

The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

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

200
400
429

Content type

[{"IMO": "9450832",
"SHIP_ID": "4615400",
"MMSI": "538003690",
"SHIPNAME": "APHRODITE M",
"SHIPCLASS": "HANDYSIZE",
"MARKET": "DRY BULK",
"MANAGER": "EMPIRE BULKERS",
"OWNER": "BANK OF AMERICA LEASING AND CAPITAL",
"FROM_PORT_ID": "257",
"FROM_PORT": "ARATU",
"NEXT_PORT_1_ID": "5018",
"NEXT_PORT_1": "FORTALEZA",
"NEXT_PORT_1_PROB": "0.400",
"NEXT_AREA_1": "ECSA",
"NEXT_AREA_1_PROB": "1.000",
"NEXT_PORT_2_ID": "5026",
"NEXT_PORT_2": "RECIFE",
"NEXT_PORT_2_PROB": "0.200",
"NEXT_AREA_2": "ECSA",
"NEXT_AREA_2_PROB": "1.000",
"NEXT_PORT_3_ID": "645",
"NEXT_PORT_3": "VITORIA",
"NEXT_PORT_3_PROB": "0.200",
"NEXT_AREA_3": "ECSA",
"NEXT_AREA_3_PROB": "1.000",
"NEXT_PORT_4_ID": "2479",
"NEXT_PORT_4": "CABEDELO",
"NEXT_PORT_4_PROB": "0.200",
"NEXT_AREA_4": "ECSA",
"NEXT_AREA_4_PROB": "1.000",
"NEXT_PORT_5_ID": "",
"NEXT_PORT_5": "",
"NEXT_PORT_5_PROB": "",
"NEXT_AREA_5": "",
"NEXT_AREA_5_PROB": ""
}
]

Fleet Predictive Destinations

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

Notes

The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

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

200
400
429

Content type

[{"IMO": "9450832",
"SHIP_ID": "4615400",
"MMSI": "538003690",
"SHIPNAME": "APHRODITE M",
"SHIPCLASS": "HANDYSIZE",
"MARKET": "DRY BULK",
"MANAGER": "EMPIRE BULKERS",
"OWNER": "BANK OF AMERICA LEASING AND CAPITAL",
"FROM_PORT_ID": "257",
"FROM_PORT": "ARATU",
"NEXT_PORT_1_ID": "5018",
"NEXT_PORT_1": "FORTALEZA",
"NEXT_PORT_1_PROB": "0.400",
"NEXT_AREA_1": "ECSA",
"NEXT_AREA_1_PROB": "1.000",
"NEXT_PORT_2_ID": "5026",
"NEXT_PORT_2": "RECIFE",
"NEXT_PORT_2_PROB": "0.200",
"NEXT_AREA_2": "ECSA",
"NEXT_AREA_2_PROB": "1.000",
"NEXT_PORT_3_ID": "645",
"NEXT_PORT_3": "VITORIA",
"NEXT_PORT_3_PROB": "0.200",
"NEXT_AREA_3": "ECSA",
"NEXT_AREA_3_PROB": "1.000",
"NEXT_PORT_4_ID": "2479",
"NEXT_PORT_4": "CABEDELO",
"NEXT_PORT_4_PROB": "0.200",
"NEXT_AREA_4": "ECSA",
"NEXT_AREA_4_PROB": "1.000",
"NEXT_PORT_5_ID": "",
"NEXT_PORT_5": "",
"NEXT_PORT_5_PROB": "",
"NEXT_AREA_5": "",
"NEXT_AREA_5_PROB": ""
}
]

Vessel ETA to Port

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

Notes

The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

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

200
400
429

Content type

Example

[{"SHIP_ID": "4615400",
"MMSI": "538003690",
"IMO": "9450832",
"LAST_PORT_ID": "133",
"LAST_PORT": "TERNEUZEN",
"LAST_PORT_UNLOCODE": "NLTNZ",
"LAST_PORT_TIME": "2020-10-23T07:20:00.000Z",
"NEXT_PORT_NAME": "ARATU",
"NEXT_PORT_UNLOCODE": "BRARB",
"ETA_PORT_NAME": "ROTTERDAM",
"ETA_PORT_UNLOCODE": "NLRTM",
"ETA_CALC": "2020-11-17T04:18:35.000Z"
}
]