Single Vessel Events

Single Vessel Port Calls

Retrieve arrival and departure information of a vessel for a specific period of time.

Notes

Data is available for dates after 2015-01-16
Information about AIS-transmitted data
MOVE_TYPE values: 1=Departure, 0=Arrival
API Rate Limit is 100 requests per minute

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 6 to get the latest
shipid required	integer A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo or mmsi
mmsi	integer The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
imo	integer The International Maritime Organization (IMO) number of the vessel you wish to track
timespan	integer Default: 2 The maximum age, in minutes, of the returned port calls. Maximum value is 2880
movetype	integer Use 0 to only receive arrivals or 1 to only receive departures. If not used, the response will include both
exclude_intransit	integer Use 1 to exclude vessels in transit
fromdate	string <date-time> Portcalls between fromdate and todate. Maximum period requested 190 days Date format: YYYY-MM-DD HH:MM
todate	string <date-time> Portcalls between fromdate and todate. Maximum period requested 190 days Date format: YYYY-MM-DD HH:MM
dwt_min	integer Data filter: minimum DWT Applicable to IMO-having vessels
dwt_max	integer Data filter: maximum DWT Applicable to IMO-having vessels
gt_min	integer Data filter: minimum GT Applicable to IMO-having vessels
gt_max	integer Data filter: maximum GT Applicable to IMO-having vessels
market	string Define market(s) for which you would like to receive port calls (single or comma separated values) - more
msgtype	string Default: "simple" Resolution of the response. Available values: simple extended If used with the value extended, the response includes voyage related data since the previous port call
protocol	string Default: "xml" Response type. Use one of the following: xml csv jsono

Responses

Response samples

Content type

Example

[{"SHIP_ID": "3351323",
"IMO": "0",
"MMSI": "244770588",
"SHIPNAME": "PIETERNELLA",
"TIMESTAMP_LT": "2020-10-20T12:15:00.000Z",
"TIMESTAMP_UTC": "2020-10-20T10:15:00.000Z",
"MOVE_TYPE": "0",
"TYPE_NAME": "Inland, Unknown",
"PORT_ID": "1766",
"PORT_NAME": "AMSTERDAM",
"PORT_COUNTRY_CODE": "",
"PORT_UNLOCODE": "NLAMS",
"MARKET": null
},
{"SHIP_ID": "241767",
"IMO": "0",
"MMSI": "244690666",
"SHIPNAME": "BRABANT",
"TIMESTAMP_LT": "2020-10-20T12:14:00.000Z",
"TIMESTAMP_UTC": "2020-10-20T10:14:00.000Z",
"MOVE_TYPE": "1",
"TYPE_NAME": "Inland, Motor Freighter",
"PORT_ID": "1766",
"PORT_NAME": "AMSTERDAM",
"PORT_COUNTRY_CODE": "",
"PORT_UNLOCODE": "NLAMS",
"MARKET": null
}
]

Single Vessel Events

Get event based intelligence for a vessel.

Notes

More information about event types here
Information about AIS-transmitted data
API Rate Limit is 100 requests per minute

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
shipid required	integer A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo or mmsi
mmsi	integer The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
imo	integer The International Maritime Organization (IMO) number of the vessel you wish to track
timespan	integer Default: 60 The maximum age, in minutes, of the returned port calls. Maximum value is 2880
fromdate	string <date-time> Vessel Events between fromdate and todate Date format: YYYY-MM-DD HH:MM:SS
todate	string <date-time> Vessel Events between fromdate and todate Date format: YYYY-MM-DD HH:MM:SS
event_type	integer You may use one or more event ids in comma separated format for the events you wish to receive
limit_events	integer Limit the number of results
protocol	string Default: "xml" Response type. Use one of the following: xml csv jsono

Responses

Response samples

Content type

[{"MMSI": "310624000",
"IMO": "",
"SHIP_ID": "",
"SHIPNAME": "QUEEN VICTORIA",
"EVENT_ID": "1",
"EVENT_NAME": "FIRST_DAILY_POS",
"EVENT_CONTENT": "At N 50° 12' 06.53'' - W 002° 41' 31.37''",
"TIMESTAMP": "2020-10-20T00:13:00.000Z"
},
{"MMSI": "310624000",
"IMO": "",
"SHIP_ID": "",
"SHIPNAME": "QUEEN VICTORIA",
"EVENT_ID": "6",
"EVENT_NAME": "UNDERWAY",
"EVENT_CONTENT": "At N 50° 35' 15.59'' - W 002° 21' 27.11''",
"TIMESTAMP": "2020-10-19T19:56:00.000Z"
}
]

Single Vessel Berth Calls

Get berth arrival and departure information for a specific vessel.

Notes

Data is available for dates after 2017-07-03
Information about AIS-transmitted data
More information about input parameters: MARKET, SHIPCLASS
API Rate Limit is 100 requests per minute

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 3 to get the latest
shipid required	integer A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo or mmsi
mmsi	integer The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
imo	integer The International Maritime Organization (IMO) number of the vessel you wish to track
timespan	integer Default: 2 The maximum age, in minutes, of the returned port calls. Maximum value is 2880
fromdate	string <date-time> Berth calls between fromdate and todate. Maximum period requested 15 days Date format: YYYY-MM-DD HH:MM:SS.
todate	string <date-time> Berth calls between fromdate and todate. Maximum period requested 15 days Date format: YYYY-MM-DD HH:MM:SS
market	string Define market for which you would like to receive berth calls - more if undefined and ship-class is also undefined, then return all if undefined and ship-class is defined, return based on ship-class if defined and ship-class is undefined, return all ship-classes of the specific market
shipclass	integer Define ship class of interest - more
dwt_min	integer Data filter: minimum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype = 7,8)
dwt_max	integer Data filter: maximum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype = 7,8)
gt_min	integer Data filter: minimum GT Applicable to IMO-having vessels
gt_max	integer Data filter: maximum GT Applicable to IMO-having vessels
movetype	integer Use 0 to include both, 1 to only receive dockings or 2 for only undockings within the defined period. If not used, only dockings are returned Available only from version 2 of the service
protocol	string Default: "xml" Response type. Use one of the following: xml csv jsono
msgtype	string Default: "simple" Resolution of the response. Available values: simple extended If used with the value extended, the response includes voyage related data since the previous port call

Responses

Response samples

Content type

Example

[{"SHIP_ID": "5567750",
"MMSI": "237710500",
"IMO": "0",
"DOCK_TIMESTAMP_LT": "2020-10-20T06:22:00.000Z",
"DOCK_TIMESTAMP_UTC": "2020-10-20T03:22:00.000Z",
"DOCK_TIMESTAMP_OFFSET": "3.000000",
"UNDOCK_TIMESTAMP_LT": "2020-10-20T06:45:00.000Z",
"UNDOCK_TIMESTAMP_UTC": "2020-10-20T03:45:00.000Z",
"UNDOCK_TIMESTAMP_OFFSET": "3.000000",
"SHIPNAME": "PILOT BOAT PY56",
"TYPE_NAME": "Pilot Vessel",
"DWT": null,
"GRT": null,
"FLAG": "GR",
"YEAR_BUILT": null,
"BERTH_ID": "6",
"BERTH_NAME": "Container Terminal",
"TERMINAL_ID": "978",
"TERMINAL_NAME": "Container Terminal",
"PORT_ID": "1",
"PORT_NAME": "PIRAEUS",
"PORT_UNLOCODE": "GRPIR",
"PORT_COUNTRY_CODE": "GR",
"DESTINATION_ID": "1",
"DESTINATION": "PIRAEUS",
"MARKET": null
},
{"SHIP_ID": "213328",
"MMSI": "240612000",
"IMO": "8008254",
"DOCK_TIMESTAMP_LT": "2020-10-20T06:24:00.000Z",
"DOCK_TIMESTAMP_UTC": "2020-10-20T03:24:00.000Z",
"DOCK_TIMESTAMP_OFFSET": "3.000000",
"UNDOCK_TIMESTAMP_LT": "2020-10-20T06:49:00.000Z",
"UNDOCK_TIMESTAMP_UTC": "2020-10-20T03:49:00.000Z",
"UNDOCK_TIMESTAMP_OFFSET": "3.000000",
"SHIPNAME": "IFESTOS 3",
"TYPE_NAME": "Tug",
"DWT": null,
"GRT": "191",
"FLAG": "GR",
"YEAR_BUILT": "1980",
"BERTH_ID": "6",
"BERTH_NAME": "Container Terminal",
"TERMINAL_ID": "978",
"TERMINAL_NAME": "Container Terminal",
"PORT_ID": "1",
"PORT_NAME": "PIRAEUS",
"PORT_UNLOCODE": "GRPIR",
"PORT_COUNTRY_CODE": "GR",
"DESTINATION_ID": null,
"DESTINATION": null,
"MARKET": null
}
]

➔ Next to Port Events