YOU ARE USING AN OUTDATED BROWSER

It is limiting your browsing experience. Please upgrade to a modern browser.

AIS data API Documentation

Get service information and usage examples for our AIS data API.
Please contact us if you need any help.

Description: Vessel Positions of a Static Fleet

Endpoint URL: https://services.marinetraffic.com/api/exportvessels/v:8

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	5	The maximum age, in minutes, of the returned positions. Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180.
msgtype	no	text	simple	If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING values -1 or 511 indicate lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Version 8 (latest)

View other: Version 7

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:8/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54"/>
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369" DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker"  DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo"  DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" />
</pos>

XML sample response [full]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369"  DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" CURRENT_PORT="" LAST_PORT="BILBAO ANCH" LAST_PORT_TIME="2017-05-16T15:37:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="20648" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" NEXT_PORT_ID="251" NEXT_PORT_UNLOCODE="IEGRN" NEXT_PORT_NAME="GREENORE" NEXT_PORT_COUNTRY="IE" ETA_CALC="2017-05-21T09:55:00" ETA_UPDATED="2017-05-19T09:07:00" DISTANCE_TO_GO="407"  DISTANCE_TRAVELLED="364"  AVG_SPEED="8.5"  MAX_SPEED="8.80000019"  />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker" DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" CURRENT_PORT="" LAST_PORT="HAMBURG" LAST_PORT_TIME="2017-05-16T15:04:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="172" LAST_PORT_UNLOCODE="DEHAM" LAST_PORT_COUNTRY="DE" NEXT_PORT_ID="1271" NEXT_PORT_UNLOCODE="ESBIO" NEXT_PORT_NAME="BILBAO" NEXT_PORT_COUNTRY="ES" ETA_CALC="2017-05-20T11:27:00" ETA_UPDATED="2017-05-19T09:13:00" DISTANCE_TO_GO="295"  DISTANCE_TRAVELLED="782"  AVG_SPEED="12"  MAX_SPEED="13.3999996"   />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.926899" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" CURRENT_PORT="" LAST_PORT="BAYONNE" LAST_PORT_TIME="2017-05-17T16:05:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="508" LAST_PORT_UNLOCODE="FRBAY" LAST_PORT_COUNTRY="FR" NEXT_PORT_ID="500" NEXT_PORT_UNLOCODE="FRSML" NEXT_PORT_NAME="SAINT MALO" NEXT_PORT_COUNTRY="FR" ETA_CALC="2017-05-20T09:11:00" ETA_UPDATED="2017-05-19T09:43:00" DISTANCE_TO_GO="183"  DISTANCE_TRAVELLED="333"  AVG_SPEED="7.80000019"  MAX_SPEED="8.5"   />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52

CSV sample response [extended]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00

CSV sample response [full]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00,,BILBAO ANCH,2017-05-16T15:37:00,,,,20648,,ES,251,IEGRN,GREENORE,IE,2017-05-21T09:55:00,2017-05-19T09:07:00,407,364,8.5,8.80000019
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00,,HAMBURG,2017-05-16T15:04:00,,,,172,DEHAM,DE,1271,ESBIO,BILBAO,ES,2017-05-20T11:27:00,2017-05-19T09:13:00,295,782,12,13.3999996
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00,,BAYONNE,2017-05-17T16:05:00,,,,508,FRBAY,FR,500,FRSML,SAINT MALO,FR,2017-05-20T09:11:00,2017-05-19T09:43:00,183,333,7.80000019,8.5

Simplified JSON sample response [simple]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52"]]

Simplified JSON sample response [extended]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00"]]

Simplified JSON sample response [full]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00","","BILBAO ANCH","2017-05-16T15:37:00","","","","20648","","ES","251","IEGRN","GREENORE","IE","2017-05-21T09:55:00","2017-05-19T09:07:00","407","364","8.5","8.80000019"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00","","HAMBURG","2017-05-16T15:04:00","","","","172","DEHAM","DE","1271","ESBIO","BILBAO","ES","2017-05-20T11:27:00","2017-05-19T09:13:00","295","782","12","13.3999996"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00","","BAYONNE","2017-05-17T16:05:00","","","","508","FRBAY","FR","500","FRSML","SAINT MALO","FR","2017-05-20T09:11:00","2017-05-19T09:43:00","183","333","7.80000019","8.5"]

JSON object sample response [simple]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52"}]

JSON object sample response [extended]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00"}]

JSON object sample response [full]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00","CURRENT_PORT":"","LAST_PORT":"BILBAO ANCH","LAST_PORT_TIME":"2017-05-16T15:37:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"20648","LAST_PORT_UNLOCODE":"","LAST_PORT_COUNTRY":"ES","NEXT_PORT_ID":"251","NEXT_PORT_UNLOCODE":"IEGRN","NEXT_PORT_NAME":"GREENORE","NEXT_PORT_COUNTRY":"IE","ETA_CALC":"2017-05-21T09:55:00","ETA_UPDATED":"2017-05-19T09:07:00","DISTANCE_TO_GO":"407","DISTANCE_TRAVELLED":"364","AVG_SPEED":"8.5","MAX_SPEED":"8.80000019"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00","CURRENT_PORT":"","LAST_PORT":"HAMBURG","LAST_PORT_TIME":"2017-05-16T15:04:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"172","LAST_PORT_UNLOCODE":"DEHAM","LAST_PORT_COUNTRY":"DE","NEXT_PORT_ID":"1271","NEXT_PORT_UNLOCODE":"ESBIO","NEXT_PORT_NAME":"BILBAO","NEXT_PORT_COUNTRY":"ES","ETA_CALC":"2017-05-20T11:27:00","ETA_UPDATED":"2017-05-19T09:13:00","DISTANCE_TO_GO":"295","DISTANCE_TRAVELLED":"782","AVG_SPEED":"12","MAX_SPEED":"13.3999996"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00","CURRENT_PORT":"","LAST_PORT":"BAYONNE","LAST_PORT_TIME":"2017-05-17T16:05:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"508","LAST_PORT_UNLOCODE":"FRBAY","LAST_PORT_COUNTRY":"FR","NEXT_PORT_ID":"500","NEXT_PORT_UNLOCODE":"FRSML","NEXT_PORT_NAME":"SAINT MALO","NEXT_PORT_COUNTRY":"FR","ETA_CALC":"2017-05-20T09:11:00","ETA_UPDATED":"2017-05-19T09:43:00","DISTANCE_TO_GO":"183","DISTANCE_TRAVELLED":"333","AVG_SPEED":"7.80000019","MAX_SPEED":"8.5"}]

Version 7

View other: Version 8 (latest)

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:7/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:7/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49"/>
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" />
</pos>

XML sample response [full]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" CURRENT_PORT="" LAST_PORT="ODESSA" LAST_PORT_TIME="2017-02-06T12:53:00" DESTINATION="LIMASSOL" ETA="2017-02-14T20:00:00" DRAUGHT="118" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="124" LAST_PORT_UNLOCODE="UAODS" LAST_PORT_COUNTRY="UA" NEXT_PORT_ID="270" NEXT_PORT_UNLOCODE="CYLMS" NEXT_PORT_NAME="LIMASSOL" NEXT_PORT_COUNTRY="CY" ETA_CALC="2017-02-14T17:18:00" ETA_UPDATED="2017-02-14T14:06:00" DISTANCE_TO_GO="27" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" CURRENT_PORT="" LAST_PORT="PIRAEUS" LAST_PORT_TIME="2017-02-14T10:47:00" DESTINATION="SUEZ" ETA="2017-02-15T20:59:00" DRAUGHT="156" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="1" LAST_PORT_UNLOCODE="GRPIR" LAST_PORT_COUNTRY="GR" NEXT_PORT_ID="17181" NEXT_PORT_UNLOCODE="EGSUZ" NEXT_PORT_NAME="SUEZ CANAL" NEXT_PORT_COUNTRY="EG" ETA_CALC="2017-02-15T21:14:00" ETA_UPDATED="2017-02-14T14:12:00" DISTANCE_TO_GO="27" />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
309542000,9252307,370190,34.328170,32.878170,119,91,92,0,2017-02-14T15:10:28,TER,29
374886000,9647461,992387,36.767090,24.143830,190,155,157,0,2017-02-14T15:10:24,TER,25

CSV sample response [extended]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY
309542000,9252307,370190,34.328500,32.862340,119,91,94,0,2017-02-14T15:06:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,34530,2003,Oil Products Tanker,Tanker
374886000,9647461,992387,36.783150,24.135430,193,156,156,0,2017-02-14T15:07:00,TER,60,MSC HAMBURG,70,3FYY8,PA,399,54,176490,186766,2015,Container Ship,Cargo

CSV sample response [full]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, ROT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, DRAUGHT, PORT_ID, PORT_UNLOCODE, PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO
309542000,9252307,370190,34.329170,32.846500,118,91,93,0,2017-02-14T15:02:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,-5,34530,2003,Oil Products Tanker,Tanker,,ODESSA,2017-02-06T12:53:00,LIMASSOL,2017-02-14T20:00:00,118,,,,124,UAODS,UA,270,CYLMS,LIMASSOL,CY,2017-02-14T17:18:00,2017-02-14T14:06:00,23
374886000,9647461,992387,36.800500,24.125940,191,157,158,0,2017-02-14T15:03:23,TER,25,MSC HAMBURG,70,3FYY8,PA,399,54,176490,0,186766,2015,Container Ship,Cargo,,PIRAEUS,2017-02-14T10:47:00,SUEZ,2017-02-15T20:59:00,156,,,,1,GRPIR,GR,17181,EGSUZ,SUEZ CANAL,EG,2017-02-15T21:14:00,2017-02-14T14:12:00,561

Simplified JSON sample response [simple]

[["309542000","9252307","370190","34.327840","32.886170","118","92","91","0","2017-02-14T15:12:28","TER","29"],
["374886000","9647461","992387","36.760870","24.147220","191","155","156","0","2017-02-14T15:11:41","TER","41"]]

Simplified JSON sample response [extended]

[["309542000","9252307","370190","34.327670","32.890000","119","91","92","0","2017-02-14T15:13:28","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","34530","2003","Oil Products Tanker","Tanker"],
["374886000","9647461","992387","36.754450","24.150640","192","157","158","0","2017-02-14T15:12:59","TER","0","MSC HAMBURG","70","3FYY8","PA","399","54","176490","186766","2015","Container Ship","Cargo"]]

Simplified JSON sample response [full]

[["309542000","9252307","370190","34.327500","32.898000","119","91","92","0","2017-02-14T15:15:27","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","-1","34530","2003","Oil Products Tanker","Tanker","","ODESSA","2017-02-06T12:53:00","LIMASSOL","2017-02-14T20:00:00","118","","","","124","UAODS","UA","270","CYLMS","LIMASSOL","CY","2017-02-14T17:25:00","2017-02-14T15:08:00","22"],
["374886000","9647461","992387","36.743010","24.156150","192","157","157","0","2017-02-14T15:15:18","TER","19","MSC HAMBURG","70","3FYY8","PA","399","54","176490","0","186766","2015","Container Ship","Cargo","","PIRAEUS","2017-02-14T10:47:00","SUEZ","2017-02-15T20:59:00","156","","","","1","GRPIR","GR","17181","EGSUZ","SUEZ CANAL","EG","2017-02-16T00:05:00","2017-02-14T15:14:00","617">]]

JSON object sample response [simple]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42"}]

JSON object sample response [extended]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN","SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG","SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo"}]

JSON object sample response [full]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN" ,"SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker","CURRENT_PORT":","LAST_PORT":ODESSA","LAST_PORT_TIME":2017-02-06T12:53:00","DESTINATION":LIMASSOL","ETA":2017-02-14T20:00:00","DRAUGHT":118","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":124","LAST_PORT_UNLOCODE":UAODS","LAST_PORT_COUNTRY":UA","NEXT_PORT_ID":270","NEXT_PORT_UNLOCODE":CYLMS","NEXT_PORT_NAME":LIMASSOL","NEXT_PORT_COUNTRY":CY","ETA_CALC":2017-02-14T17:18:00","ETA_UPDATED":2017-02-14T14:06:00","DISTANCE_TO_GO":27"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG" ,"SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo","CURRENT_PORT":","LAST_PORT":PIRAEUS","LAST_PORT_TIME":2017-02-14T10:47:00","DESTINATION":SUEZ","ETA":2017-02-15T20:59:00","DRAUGHT":156","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":1","LAST_PORT_UNLOCODE":GRPIR","LAST_PORT_COUNTRY":GR","NEXT_PORT_ID":17181","NEXT_PORT_UNLOCODE":EGSUZ","NEXT_PORT_NAME":SUEZ CANAL","NEXT_PORT_COUNTRY":EG","ETA_CALC":2017-02-15T21:14:00","ETA_UPDATED":2017-02-14T14:12:00","DISTANCE_TO_GO":27"}]

Version 8 (latest)

View other: Version 7

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT	integer	The year that the subject vessel was built
ROT	integer	Rate of Turn
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
CURRENT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED	real	The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED	real	The maximum speed reported by the subject vessel during the latest voyage (port to port)

Version 7

View other: Version 8 (latest)

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination

Description: Vessel Positions of a Dynamic Fleet

Endpoint URL: https://services.marinetraffic.com/api/exportvessels/v:8

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	5	The maximum age, in minutes, of the returned positions. Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180.
msgtype	no	text	simple	If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING values -1 or 511 indicate lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Version 8 (latest)

View other: Version 7

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:8/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54"/>
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369" DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker"  DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo"  DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" />
</pos>

XML sample response [full]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369"  DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" CURRENT_PORT="" LAST_PORT="BILBAO ANCH" LAST_PORT_TIME="2017-05-16T15:37:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="20648" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" NEXT_PORT_ID="251" NEXT_PORT_UNLOCODE="IEGRN" NEXT_PORT_NAME="GREENORE" NEXT_PORT_COUNTRY="IE" ETA_CALC="2017-05-21T09:55:00" ETA_UPDATED="2017-05-19T09:07:00" DISTANCE_TO_GO="407"  DISTANCE_TRAVELLED="364"  AVG_SPEED="8.5"  MAX_SPEED="8.80000019"  />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker" DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" CURRENT_PORT="" LAST_PORT="HAMBURG" LAST_PORT_TIME="2017-05-16T15:04:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="172" LAST_PORT_UNLOCODE="DEHAM" LAST_PORT_COUNTRY="DE" NEXT_PORT_ID="1271" NEXT_PORT_UNLOCODE="ESBIO" NEXT_PORT_NAME="BILBAO" NEXT_PORT_COUNTRY="ES" ETA_CALC="2017-05-20T11:27:00" ETA_UPDATED="2017-05-19T09:13:00" DISTANCE_TO_GO="295"  DISTANCE_TRAVELLED="782"  AVG_SPEED="12"  MAX_SPEED="13.3999996"   />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.926899" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" CURRENT_PORT="" LAST_PORT="BAYONNE" LAST_PORT_TIME="2017-05-17T16:05:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="508" LAST_PORT_UNLOCODE="FRBAY" LAST_PORT_COUNTRY="FR" NEXT_PORT_ID="500" NEXT_PORT_UNLOCODE="FRSML" NEXT_PORT_NAME="SAINT MALO" NEXT_PORT_COUNTRY="FR" ETA_CALC="2017-05-20T09:11:00" ETA_UPDATED="2017-05-19T09:43:00" DISTANCE_TO_GO="183"  DISTANCE_TRAVELLED="333"  AVG_SPEED="7.80000019"  MAX_SPEED="8.5"   />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52

CSV sample response [extended]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00

CSV sample response [full]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00,,BILBAO ANCH,2017-05-16T15:37:00,,,,20648,,ES,251,IEGRN,GREENORE,IE,2017-05-21T09:55:00,2017-05-19T09:07:00,407,364,8.5,8.80000019
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00,,HAMBURG,2017-05-16T15:04:00,,,,172,DEHAM,DE,1271,ESBIO,BILBAO,ES,2017-05-20T11:27:00,2017-05-19T09:13:00,295,782,12,13.3999996
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00,,BAYONNE,2017-05-17T16:05:00,,,,508,FRBAY,FR,500,FRSML,SAINT MALO,FR,2017-05-20T09:11:00,2017-05-19T09:43:00,183,333,7.80000019,8.5

Simplified JSON sample response [simple]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52"]]

Simplified JSON sample response [extended]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00"]]

Simplified JSON sample response [full]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00","","BILBAO ANCH","2017-05-16T15:37:00","","","","20648","","ES","251","IEGRN","GREENORE","IE","2017-05-21T09:55:00","2017-05-19T09:07:00","407","364","8.5","8.80000019"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00","","HAMBURG","2017-05-16T15:04:00","","","","172","DEHAM","DE","1271","ESBIO","BILBAO","ES","2017-05-20T11:27:00","2017-05-19T09:13:00","295","782","12","13.3999996"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00","","BAYONNE","2017-05-17T16:05:00","","","","508","FRBAY","FR","500","FRSML","SAINT MALO","FR","2017-05-20T09:11:00","2017-05-19T09:43:00","183","333","7.80000019","8.5"]

JSON object sample response [simple]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52"}]

JSON object sample response [extended]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00"}]

JSON object sample response [full]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00","CURRENT_PORT":"","LAST_PORT":"BILBAO ANCH","LAST_PORT_TIME":"2017-05-16T15:37:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"20648","LAST_PORT_UNLOCODE":"","LAST_PORT_COUNTRY":"ES","NEXT_PORT_ID":"251","NEXT_PORT_UNLOCODE":"IEGRN","NEXT_PORT_NAME":"GREENORE","NEXT_PORT_COUNTRY":"IE","ETA_CALC":"2017-05-21T09:55:00","ETA_UPDATED":"2017-05-19T09:07:00","DISTANCE_TO_GO":"407","DISTANCE_TRAVELLED":"364","AVG_SPEED":"8.5","MAX_SPEED":"8.80000019"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00","CURRENT_PORT":"","LAST_PORT":"HAMBURG","LAST_PORT_TIME":"2017-05-16T15:04:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"172","LAST_PORT_UNLOCODE":"DEHAM","LAST_PORT_COUNTRY":"DE","NEXT_PORT_ID":"1271","NEXT_PORT_UNLOCODE":"ESBIO","NEXT_PORT_NAME":"BILBAO","NEXT_PORT_COUNTRY":"ES","ETA_CALC":"2017-05-20T11:27:00","ETA_UPDATED":"2017-05-19T09:13:00","DISTANCE_TO_GO":"295","DISTANCE_TRAVELLED":"782","AVG_SPEED":"12","MAX_SPEED":"13.3999996"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00","CURRENT_PORT":"","LAST_PORT":"BAYONNE","LAST_PORT_TIME":"2017-05-17T16:05:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"508","LAST_PORT_UNLOCODE":"FRBAY","LAST_PORT_COUNTRY":"FR","NEXT_PORT_ID":"500","NEXT_PORT_UNLOCODE":"FRSML","NEXT_PORT_NAME":"SAINT MALO","NEXT_PORT_COUNTRY":"FR","ETA_CALC":"2017-05-20T09:11:00","ETA_UPDATED":"2017-05-19T09:43:00","DISTANCE_TO_GO":"183","DISTANCE_TRAVELLED":"333","AVG_SPEED":"7.80000019","MAX_SPEED":"8.5"}]

Version 7

View other: Version 8 (latest)

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:7/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:7/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49"/>
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" />
</pos>

XML sample response [full]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" CURRENT_PORT="" LAST_PORT="ODESSA" LAST_PORT_TIME="2017-02-06T12:53:00" DESTINATION="LIMASSOL" ETA="2017-02-14T20:00:00" DRAUGHT="118" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="124" LAST_PORT_UNLOCODE="UAODS" LAST_PORT_COUNTRY="UA" NEXT_PORT_ID="270" NEXT_PORT_UNLOCODE="CYLMS" NEXT_PORT_NAME="LIMASSOL" NEXT_PORT_COUNTRY="CY" ETA_CALC="2017-02-14T17:18:00" ETA_UPDATED="2017-02-14T14:06:00" DISTANCE_TO_GO="27" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" CURRENT_PORT="" LAST_PORT="PIRAEUS" LAST_PORT_TIME="2017-02-14T10:47:00" DESTINATION="SUEZ" ETA="2017-02-15T20:59:00" DRAUGHT="156" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="1" LAST_PORT_UNLOCODE="GRPIR" LAST_PORT_COUNTRY="GR" NEXT_PORT_ID="17181" NEXT_PORT_UNLOCODE="EGSUZ" NEXT_PORT_NAME="SUEZ CANAL" NEXT_PORT_COUNTRY="EG" ETA_CALC="2017-02-15T21:14:00" ETA_UPDATED="2017-02-14T14:12:00" DISTANCE_TO_GO="27" />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
309542000,9252307,370190,34.328170,32.878170,119,91,92,0,2017-02-14T15:10:28,TER,29
374886000,9647461,992387,36.767090,24.143830,190,155,157,0,2017-02-14T15:10:24,TER,25

CSV sample response [extended]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY
309542000,9252307,370190,34.328500,32.862340,119,91,94,0,2017-02-14T15:06:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,34530,2003,Oil Products Tanker,Tanker
374886000,9647461,992387,36.783150,24.135430,193,156,156,0,2017-02-14T15:07:00,TER,60,MSC HAMBURG,70,3FYY8,PA,399,54,176490,186766,2015,Container Ship,Cargo

CSV sample response [full]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, ROT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, DRAUGHT, PORT_ID, PORT_UNLOCODE, PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO
309542000,9252307,370190,34.329170,32.846500,118,91,93,0,2017-02-14T15:02:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,-5,34530,2003,Oil Products Tanker,Tanker,,ODESSA,2017-02-06T12:53:00,LIMASSOL,2017-02-14T20:00:00,118,,,,124,UAODS,UA,270,CYLMS,LIMASSOL,CY,2017-02-14T17:18:00,2017-02-14T14:06:00,23
374886000,9647461,992387,36.800500,24.125940,191,157,158,0,2017-02-14T15:03:23,TER,25,MSC HAMBURG,70,3FYY8,PA,399,54,176490,0,186766,2015,Container Ship,Cargo,,PIRAEUS,2017-02-14T10:47:00,SUEZ,2017-02-15T20:59:00,156,,,,1,GRPIR,GR,17181,EGSUZ,SUEZ CANAL,EG,2017-02-15T21:14:00,2017-02-14T14:12:00,561

Simplified JSON sample response [simple]

[["309542000","9252307","370190","34.327840","32.886170","118","92","91","0","2017-02-14T15:12:28","TER","29"],
["374886000","9647461","992387","36.760870","24.147220","191","155","156","0","2017-02-14T15:11:41","TER","41"]]

Simplified JSON sample response [extended]

[["309542000","9252307","370190","34.327670","32.890000","119","91","92","0","2017-02-14T15:13:28","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","34530","2003","Oil Products Tanker","Tanker"],
["374886000","9647461","992387","36.754450","24.150640","192","157","158","0","2017-02-14T15:12:59","TER","0","MSC HAMBURG","70","3FYY8","PA","399","54","176490","186766","2015","Container Ship","Cargo"]]

Simplified JSON sample response [full]

[["309542000","9252307","370190","34.327500","32.898000","119","91","92","0","2017-02-14T15:15:27","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","-1","34530","2003","Oil Products Tanker","Tanker","","ODESSA","2017-02-06T12:53:00","LIMASSOL","2017-02-14T20:00:00","118","","","","124","UAODS","UA","270","CYLMS","LIMASSOL","CY","2017-02-14T17:25:00","2017-02-14T15:08:00","22"],
["374886000","9647461","992387","36.743010","24.156150","192","157","157","0","2017-02-14T15:15:18","TER","19","MSC HAMBURG","70","3FYY8","PA","399","54","176490","0","186766","2015","Container Ship","Cargo","","PIRAEUS","2017-02-14T10:47:00","SUEZ","2017-02-15T20:59:00","156","","","","1","GRPIR","GR","17181","EGSUZ","SUEZ CANAL","EG","2017-02-16T00:05:00","2017-02-14T15:14:00","617">]]

JSON object sample response [simple]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42"}]

JSON object sample response [extended]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN","SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG","SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo"}]

JSON object sample response [full]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN" ,"SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker","CURRENT_PORT":","LAST_PORT":ODESSA","LAST_PORT_TIME":2017-02-06T12:53:00","DESTINATION":LIMASSOL","ETA":2017-02-14T20:00:00","DRAUGHT":118","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":124","LAST_PORT_UNLOCODE":UAODS","LAST_PORT_COUNTRY":UA","NEXT_PORT_ID":270","NEXT_PORT_UNLOCODE":CYLMS","NEXT_PORT_NAME":LIMASSOL","NEXT_PORT_COUNTRY":CY","ETA_CALC":2017-02-14T17:18:00","ETA_UPDATED":2017-02-14T14:06:00","DISTANCE_TO_GO":27"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG" ,"SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo","CURRENT_PORT":","LAST_PORT":PIRAEUS","LAST_PORT_TIME":2017-02-14T10:47:00","DESTINATION":SUEZ","ETA":2017-02-15T20:59:00","DRAUGHT":156","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":1","LAST_PORT_UNLOCODE":GRPIR","LAST_PORT_COUNTRY":GR","NEXT_PORT_ID":17181","NEXT_PORT_UNLOCODE":EGSUZ","NEXT_PORT_NAME":SUEZ CANAL","NEXT_PORT_COUNTRY":EG","ETA_CALC":2017-02-15T21:14:00","ETA_UPDATED":2017-02-14T14:12:00","DISTANCE_TO_GO":27"}]

Version 8 (latest)

View other: Version 7

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT	integer	The year that the subject vessel was built
ROT	integer	Rate of Turn
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
CURRENT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED	real	The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED	real	The maximum speed reported by the subject vessel during the latest voyage (port to port)

Version 7

View other: Version 8 (latest)

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination

Description: Vessel Positions within a Port

Endpoint URL: https://services.marinetraffic.com/api/exportvessels/v:8

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	5	The maximum age, in minutes, of the returned positions. Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180.
msgtype	no	text	simple	If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING values -1 or 511 indicate lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Version 8 (latest)

View other: Version 7

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:8/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54"/>
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369" DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker"  DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo"  DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" />
</pos>

XML sample response [full]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369"  DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" CURRENT_PORT="" LAST_PORT="BILBAO ANCH" LAST_PORT_TIME="2017-05-16T15:37:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="20648" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" NEXT_PORT_ID="251" NEXT_PORT_UNLOCODE="IEGRN" NEXT_PORT_NAME="GREENORE" NEXT_PORT_COUNTRY="IE" ETA_CALC="2017-05-21T09:55:00" ETA_UPDATED="2017-05-19T09:07:00" DISTANCE_TO_GO="407"  DISTANCE_TRAVELLED="364"  AVG_SPEED="8.5"  MAX_SPEED="8.80000019"  />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker" DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" CURRENT_PORT="" LAST_PORT="HAMBURG" LAST_PORT_TIME="2017-05-16T15:04:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="172" LAST_PORT_UNLOCODE="DEHAM" LAST_PORT_COUNTRY="DE" NEXT_PORT_ID="1271" NEXT_PORT_UNLOCODE="ESBIO" NEXT_PORT_NAME="BILBAO" NEXT_PORT_COUNTRY="ES" ETA_CALC="2017-05-20T11:27:00" ETA_UPDATED="2017-05-19T09:13:00" DISTANCE_TO_GO="295"  DISTANCE_TRAVELLED="782"  AVG_SPEED="12"  MAX_SPEED="13.3999996"   />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.926899" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" CURRENT_PORT="" LAST_PORT="BAYONNE" LAST_PORT_TIME="2017-05-17T16:05:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="508" LAST_PORT_UNLOCODE="FRBAY" LAST_PORT_COUNTRY="FR" NEXT_PORT_ID="500" NEXT_PORT_UNLOCODE="FRSML" NEXT_PORT_NAME="SAINT MALO" NEXT_PORT_COUNTRY="FR" ETA_CALC="2017-05-20T09:11:00" ETA_UPDATED="2017-05-19T09:43:00" DISTANCE_TO_GO="183"  DISTANCE_TRAVELLED="333"  AVG_SPEED="7.80000019"  MAX_SPEED="8.5"   />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52

CSV sample response [extended]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00

CSV sample response [full]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00,,BILBAO ANCH,2017-05-16T15:37:00,,,,20648,,ES,251,IEGRN,GREENORE,IE,2017-05-21T09:55:00,2017-05-19T09:07:00,407,364,8.5,8.80000019
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00,,HAMBURG,2017-05-16T15:04:00,,,,172,DEHAM,DE,1271,ESBIO,BILBAO,ES,2017-05-20T11:27:00,2017-05-19T09:13:00,295,782,12,13.3999996
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00,,BAYONNE,2017-05-17T16:05:00,,,,508,FRBAY,FR,500,FRSML,SAINT MALO,FR,2017-05-20T09:11:00,2017-05-19T09:43:00,183,333,7.80000019,8.5

Simplified JSON sample response [simple]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52"]]

Simplified JSON sample response [extended]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00"]]

Simplified JSON sample response [full]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00","","BILBAO ANCH","2017-05-16T15:37:00","","","","20648","","ES","251","IEGRN","GREENORE","IE","2017-05-21T09:55:00","2017-05-19T09:07:00","407","364","8.5","8.80000019"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00","","HAMBURG","2017-05-16T15:04:00","","","","172","DEHAM","DE","1271","ESBIO","BILBAO","ES","2017-05-20T11:27:00","2017-05-19T09:13:00","295","782","12","13.3999996"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00","","BAYONNE","2017-05-17T16:05:00","","","","508","FRBAY","FR","500","FRSML","SAINT MALO","FR","2017-05-20T09:11:00","2017-05-19T09:43:00","183","333","7.80000019","8.5"]

JSON object sample response [simple]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52"}]

JSON object sample response [extended]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00"}]

JSON object sample response [full]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00","CURRENT_PORT":"","LAST_PORT":"BILBAO ANCH","LAST_PORT_TIME":"2017-05-16T15:37:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"20648","LAST_PORT_UNLOCODE":"","LAST_PORT_COUNTRY":"ES","NEXT_PORT_ID":"251","NEXT_PORT_UNLOCODE":"IEGRN","NEXT_PORT_NAME":"GREENORE","NEXT_PORT_COUNTRY":"IE","ETA_CALC":"2017-05-21T09:55:00","ETA_UPDATED":"2017-05-19T09:07:00","DISTANCE_TO_GO":"407","DISTANCE_TRAVELLED":"364","AVG_SPEED":"8.5","MAX_SPEED":"8.80000019"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00","CURRENT_PORT":"","LAST_PORT":"HAMBURG","LAST_PORT_TIME":"2017-05-16T15:04:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"172","LAST_PORT_UNLOCODE":"DEHAM","LAST_PORT_COUNTRY":"DE","NEXT_PORT_ID":"1271","NEXT_PORT_UNLOCODE":"ESBIO","NEXT_PORT_NAME":"BILBAO","NEXT_PORT_COUNTRY":"ES","ETA_CALC":"2017-05-20T11:27:00","ETA_UPDATED":"2017-05-19T09:13:00","DISTANCE_TO_GO":"295","DISTANCE_TRAVELLED":"782","AVG_SPEED":"12","MAX_SPEED":"13.3999996"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00","CURRENT_PORT":"","LAST_PORT":"BAYONNE","LAST_PORT_TIME":"2017-05-17T16:05:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"508","LAST_PORT_UNLOCODE":"FRBAY","LAST_PORT_COUNTRY":"FR","NEXT_PORT_ID":"500","NEXT_PORT_UNLOCODE":"FRSML","NEXT_PORT_NAME":"SAINT MALO","NEXT_PORT_COUNTRY":"FR","ETA_CALC":"2017-05-20T09:11:00","ETA_UPDATED":"2017-05-19T09:43:00","DISTANCE_TO_GO":"183","DISTANCE_TRAVELLED":"333","AVG_SPEED":"7.80000019","MAX_SPEED":"8.5"}]

Version 7

View other: Version 8 (latest)

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:7/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:7/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49"/>
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" />
</pos>

XML sample response [full]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" CURRENT_PORT="" LAST_PORT="ODESSA" LAST_PORT_TIME="2017-02-06T12:53:00" DESTINATION="LIMASSOL" ETA="2017-02-14T20:00:00" DRAUGHT="118" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="124" LAST_PORT_UNLOCODE="UAODS" LAST_PORT_COUNTRY="UA" NEXT_PORT_ID="270" NEXT_PORT_UNLOCODE="CYLMS" NEXT_PORT_NAME="LIMASSOL" NEXT_PORT_COUNTRY="CY" ETA_CALC="2017-02-14T17:18:00" ETA_UPDATED="2017-02-14T14:06:00" DISTANCE_TO_GO="27" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" CURRENT_PORT="" LAST_PORT="PIRAEUS" LAST_PORT_TIME="2017-02-14T10:47:00" DESTINATION="SUEZ" ETA="2017-02-15T20:59:00" DRAUGHT="156" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="1" LAST_PORT_UNLOCODE="GRPIR" LAST_PORT_COUNTRY="GR" NEXT_PORT_ID="17181" NEXT_PORT_UNLOCODE="EGSUZ" NEXT_PORT_NAME="SUEZ CANAL" NEXT_PORT_COUNTRY="EG" ETA_CALC="2017-02-15T21:14:00" ETA_UPDATED="2017-02-14T14:12:00" DISTANCE_TO_GO="27" />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
309542000,9252307,370190,34.328170,32.878170,119,91,92,0,2017-02-14T15:10:28,TER,29
374886000,9647461,992387,36.767090,24.143830,190,155,157,0,2017-02-14T15:10:24,TER,25

CSV sample response [extended]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY
309542000,9252307,370190,34.328500,32.862340,119,91,94,0,2017-02-14T15:06:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,34530,2003,Oil Products Tanker,Tanker
374886000,9647461,992387,36.783150,24.135430,193,156,156,0,2017-02-14T15:07:00,TER,60,MSC HAMBURG,70,3FYY8,PA,399,54,176490,186766,2015,Container Ship,Cargo

CSV sample response [full]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, ROT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, DRAUGHT, PORT_ID, PORT_UNLOCODE, PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO
309542000,9252307,370190,34.329170,32.846500,118,91,93,0,2017-02-14T15:02:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,-5,34530,2003,Oil Products Tanker,Tanker,,ODESSA,2017-02-06T12:53:00,LIMASSOL,2017-02-14T20:00:00,118,,,,124,UAODS,UA,270,CYLMS,LIMASSOL,CY,2017-02-14T17:18:00,2017-02-14T14:06:00,23
374886000,9647461,992387,36.800500,24.125940,191,157,158,0,2017-02-14T15:03:23,TER,25,MSC HAMBURG,70,3FYY8,PA,399,54,176490,0,186766,2015,Container Ship,Cargo,,PIRAEUS,2017-02-14T10:47:00,SUEZ,2017-02-15T20:59:00,156,,,,1,GRPIR,GR,17181,EGSUZ,SUEZ CANAL,EG,2017-02-15T21:14:00,2017-02-14T14:12:00,561

Simplified JSON sample response [simple]

[["309542000","9252307","370190","34.327840","32.886170","118","92","91","0","2017-02-14T15:12:28","TER","29"],
["374886000","9647461","992387","36.760870","24.147220","191","155","156","0","2017-02-14T15:11:41","TER","41"]]

Simplified JSON sample response [extended]

[["309542000","9252307","370190","34.327670","32.890000","119","91","92","0","2017-02-14T15:13:28","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","34530","2003","Oil Products Tanker","Tanker"],
["374886000","9647461","992387","36.754450","24.150640","192","157","158","0","2017-02-14T15:12:59","TER","0","MSC HAMBURG","70","3FYY8","PA","399","54","176490","186766","2015","Container Ship","Cargo"]]

Simplified JSON sample response [full]

[["309542000","9252307","370190","34.327500","32.898000","119","91","92","0","2017-02-14T15:15:27","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","-1","34530","2003","Oil Products Tanker","Tanker","","ODESSA","2017-02-06T12:53:00","LIMASSOL","2017-02-14T20:00:00","118","","","","124","UAODS","UA","270","CYLMS","LIMASSOL","CY","2017-02-14T17:25:00","2017-02-14T15:08:00","22"],
["374886000","9647461","992387","36.743010","24.156150","192","157","157","0","2017-02-14T15:15:18","TER","19","MSC HAMBURG","70","3FYY8","PA","399","54","176490","0","186766","2015","Container Ship","Cargo","","PIRAEUS","2017-02-14T10:47:00","SUEZ","2017-02-15T20:59:00","156","","","","1","GRPIR","GR","17181","EGSUZ","SUEZ CANAL","EG","2017-02-16T00:05:00","2017-02-14T15:14:00","617">]]

JSON object sample response [simple]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42"}]

JSON object sample response [extended]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN","SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG","SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo"}]

JSON object sample response [full]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN" ,"SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker","CURRENT_PORT":","LAST_PORT":ODESSA","LAST_PORT_TIME":2017-02-06T12:53:00","DESTINATION":LIMASSOL","ETA":2017-02-14T20:00:00","DRAUGHT":118","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":124","LAST_PORT_UNLOCODE":UAODS","LAST_PORT_COUNTRY":UA","NEXT_PORT_ID":270","NEXT_PORT_UNLOCODE":CYLMS","NEXT_PORT_NAME":LIMASSOL","NEXT_PORT_COUNTRY":CY","ETA_CALC":2017-02-14T17:18:00","ETA_UPDATED":2017-02-14T14:06:00","DISTANCE_TO_GO":27"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG" ,"SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo","CURRENT_PORT":","LAST_PORT":PIRAEUS","LAST_PORT_TIME":2017-02-14T10:47:00","DESTINATION":SUEZ","ETA":2017-02-15T20:59:00","DRAUGHT":156","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":1","LAST_PORT_UNLOCODE":GRPIR","LAST_PORT_COUNTRY":GR","NEXT_PORT_ID":17181","NEXT_PORT_UNLOCODE":EGSUZ","NEXT_PORT_NAME":SUEZ CANAL","NEXT_PORT_COUNTRY":EG","ETA_CALC":2017-02-15T21:14:00","ETA_UPDATED":2017-02-14T14:12:00","DISTANCE_TO_GO":27"}]

Version 8 (latest)

View other: Version 7

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT	integer	The year that the subject vessel was built
ROT	integer	Rate of Turn
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
CURRENT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED	real	The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED	real	The maximum speed reported by the subject vessel during the latest voyage (port to port)

Version 7

View other: Version 8 (latest)

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination

Description: Vessel Positions in a Predefined Bounding Box

Endpoint URL: https://services.marinetraffic.com/api/exportvessels/v:8

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	5	The maximum age, in minutes, of the returned positions. Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180.
msgtype	no	text	simple	If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING values -1 or 511 indicate lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Version 8 (latest)

View other: Version 7

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:8/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54"/>
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369" DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker"  DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo"  DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" />
</pos>

XML sample response [full]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369"  DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" CURRENT_PORT="" LAST_PORT="BILBAO ANCH" LAST_PORT_TIME="2017-05-16T15:37:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="20648" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" NEXT_PORT_ID="251" NEXT_PORT_UNLOCODE="IEGRN" NEXT_PORT_NAME="GREENORE" NEXT_PORT_COUNTRY="IE" ETA_CALC="2017-05-21T09:55:00" ETA_UPDATED="2017-05-19T09:07:00" DISTANCE_TO_GO="407"  DISTANCE_TRAVELLED="364"  AVG_SPEED="8.5"  MAX_SPEED="8.80000019"  />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker" DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" CURRENT_PORT="" LAST_PORT="HAMBURG" LAST_PORT_TIME="2017-05-16T15:04:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="172" LAST_PORT_UNLOCODE="DEHAM" LAST_PORT_COUNTRY="DE" NEXT_PORT_ID="1271" NEXT_PORT_UNLOCODE="ESBIO" NEXT_PORT_NAME="BILBAO" NEXT_PORT_COUNTRY="ES" ETA_CALC="2017-05-20T11:27:00" ETA_UPDATED="2017-05-19T09:13:00" DISTANCE_TO_GO="295"  DISTANCE_TRAVELLED="782"  AVG_SPEED="12"  MAX_SPEED="13.3999996"   />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.926899" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" CURRENT_PORT="" LAST_PORT="BAYONNE" LAST_PORT_TIME="2017-05-17T16:05:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="508" LAST_PORT_UNLOCODE="FRBAY" LAST_PORT_COUNTRY="FR" NEXT_PORT_ID="500" NEXT_PORT_UNLOCODE="FRSML" NEXT_PORT_NAME="SAINT MALO" NEXT_PORT_COUNTRY="FR" ETA_CALC="2017-05-20T09:11:00" ETA_UPDATED="2017-05-19T09:43:00" DISTANCE_TO_GO="183"  DISTANCE_TRAVELLED="333"  AVG_SPEED="7.80000019"  MAX_SPEED="8.5"   />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52

CSV sample response [extended]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00

CSV sample response [full]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00,,BILBAO ANCH,2017-05-16T15:37:00,,,,20648,,ES,251,IEGRN,GREENORE,IE,2017-05-21T09:55:00,2017-05-19T09:07:00,407,364,8.5,8.80000019
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00,,HAMBURG,2017-05-16T15:04:00,,,,172,DEHAM,DE,1271,ESBIO,BILBAO,ES,2017-05-20T11:27:00,2017-05-19T09:13:00,295,782,12,13.3999996
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00,,BAYONNE,2017-05-17T16:05:00,,,,508,FRBAY,FR,500,FRSML,SAINT MALO,FR,2017-05-20T09:11:00,2017-05-19T09:43:00,183,333,7.80000019,8.5

Simplified JSON sample response [simple]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52"]]

Simplified JSON sample response [extended]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00"]]

Simplified JSON sample response [full]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00","","BILBAO ANCH","2017-05-16T15:37:00","","","","20648","","ES","251","IEGRN","GREENORE","IE","2017-05-21T09:55:00","2017-05-19T09:07:00","407","364","8.5","8.80000019"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00","","HAMBURG","2017-05-16T15:04:00","","","","172","DEHAM","DE","1271","ESBIO","BILBAO","ES","2017-05-20T11:27:00","2017-05-19T09:13:00","295","782","12","13.3999996"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00","","BAYONNE","2017-05-17T16:05:00","","","","508","FRBAY","FR","500","FRSML","SAINT MALO","FR","2017-05-20T09:11:00","2017-05-19T09:43:00","183","333","7.80000019","8.5"]

JSON object sample response [simple]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52"}]

JSON object sample response [extended]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00"}]

JSON object sample response [full]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00","CURRENT_PORT":"","LAST_PORT":"BILBAO ANCH","LAST_PORT_TIME":"2017-05-16T15:37:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"20648","LAST_PORT_UNLOCODE":"","LAST_PORT_COUNTRY":"ES","NEXT_PORT_ID":"251","NEXT_PORT_UNLOCODE":"IEGRN","NEXT_PORT_NAME":"GREENORE","NEXT_PORT_COUNTRY":"IE","ETA_CALC":"2017-05-21T09:55:00","ETA_UPDATED":"2017-05-19T09:07:00","DISTANCE_TO_GO":"407","DISTANCE_TRAVELLED":"364","AVG_SPEED":"8.5","MAX_SPEED":"8.80000019"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00","CURRENT_PORT":"","LAST_PORT":"HAMBURG","LAST_PORT_TIME":"2017-05-16T15:04:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"172","LAST_PORT_UNLOCODE":"DEHAM","LAST_PORT_COUNTRY":"DE","NEXT_PORT_ID":"1271","NEXT_PORT_UNLOCODE":"ESBIO","NEXT_PORT_NAME":"BILBAO","NEXT_PORT_COUNTRY":"ES","ETA_CALC":"2017-05-20T11:27:00","ETA_UPDATED":"2017-05-19T09:13:00","DISTANCE_TO_GO":"295","DISTANCE_TRAVELLED":"782","AVG_SPEED":"12","MAX_SPEED":"13.3999996"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00","CURRENT_PORT":"","LAST_PORT":"BAYONNE","LAST_PORT_TIME":"2017-05-17T16:05:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"508","LAST_PORT_UNLOCODE":"FRBAY","LAST_PORT_COUNTRY":"FR","NEXT_PORT_ID":"500","NEXT_PORT_UNLOCODE":"FRSML","NEXT_PORT_NAME":"SAINT MALO","NEXT_PORT_COUNTRY":"FR","ETA_CALC":"2017-05-20T09:11:00","ETA_UPDATED":"2017-05-19T09:43:00","DISTANCE_TO_GO":"183","DISTANCE_TRAVELLED":"333","AVG_SPEED":"7.80000019","MAX_SPEED":"8.5"}]

Version 7

View other: Version 8 (latest)

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:7/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:7/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49"/>
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" />
</pos>

XML sample response [full]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" CURRENT_PORT="" LAST_PORT="ODESSA" LAST_PORT_TIME="2017-02-06T12:53:00" DESTINATION="LIMASSOL" ETA="2017-02-14T20:00:00" DRAUGHT="118" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="124" LAST_PORT_UNLOCODE="UAODS" LAST_PORT_COUNTRY="UA" NEXT_PORT_ID="270" NEXT_PORT_UNLOCODE="CYLMS" NEXT_PORT_NAME="LIMASSOL" NEXT_PORT_COUNTRY="CY" ETA_CALC="2017-02-14T17:18:00" ETA_UPDATED="2017-02-14T14:06:00" DISTANCE_TO_GO="27" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" CURRENT_PORT="" LAST_PORT="PIRAEUS" LAST_PORT_TIME="2017-02-14T10:47:00" DESTINATION="SUEZ" ETA="2017-02-15T20:59:00" DRAUGHT="156" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="1" LAST_PORT_UNLOCODE="GRPIR" LAST_PORT_COUNTRY="GR" NEXT_PORT_ID="17181" NEXT_PORT_UNLOCODE="EGSUZ" NEXT_PORT_NAME="SUEZ CANAL" NEXT_PORT_COUNTRY="EG" ETA_CALC="2017-02-15T21:14:00" ETA_UPDATED="2017-02-14T14:12:00" DISTANCE_TO_GO="27" />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
309542000,9252307,370190,34.328170,32.878170,119,91,92,0,2017-02-14T15:10:28,TER,29
374886000,9647461,992387,36.767090,24.143830,190,155,157,0,2017-02-14T15:10:24,TER,25

CSV sample response [extended]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY
309542000,9252307,370190,34.328500,32.862340,119,91,94,0,2017-02-14T15:06:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,34530,2003,Oil Products Tanker,Tanker
374886000,9647461,992387,36.783150,24.135430,193,156,156,0,2017-02-14T15:07:00,TER,60,MSC HAMBURG,70,3FYY8,PA,399,54,176490,186766,2015,Container Ship,Cargo

CSV sample response [full]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, ROT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, DRAUGHT, PORT_ID, PORT_UNLOCODE, PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO
309542000,9252307,370190,34.329170,32.846500,118,91,93,0,2017-02-14T15:02:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,-5,34530,2003,Oil Products Tanker,Tanker,,ODESSA,2017-02-06T12:53:00,LIMASSOL,2017-02-14T20:00:00,118,,,,124,UAODS,UA,270,CYLMS,LIMASSOL,CY,2017-02-14T17:18:00,2017-02-14T14:06:00,23
374886000,9647461,992387,36.800500,24.125940,191,157,158,0,2017-02-14T15:03:23,TER,25,MSC HAMBURG,70,3FYY8,PA,399,54,176490,0,186766,2015,Container Ship,Cargo,,PIRAEUS,2017-02-14T10:47:00,SUEZ,2017-02-15T20:59:00,156,,,,1,GRPIR,GR,17181,EGSUZ,SUEZ CANAL,EG,2017-02-15T21:14:00,2017-02-14T14:12:00,561

Simplified JSON sample response [simple]

[["309542000","9252307","370190","34.327840","32.886170","118","92","91","0","2017-02-14T15:12:28","TER","29"],
["374886000","9647461","992387","36.760870","24.147220","191","155","156","0","2017-02-14T15:11:41","TER","41"]]

Simplified JSON sample response [extended]

[["309542000","9252307","370190","34.327670","32.890000","119","91","92","0","2017-02-14T15:13:28","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","34530","2003","Oil Products Tanker","Tanker"],
["374886000","9647461","992387","36.754450","24.150640","192","157","158","0","2017-02-14T15:12:59","TER","0","MSC HAMBURG","70","3FYY8","PA","399","54","176490","186766","2015","Container Ship","Cargo"]]

Simplified JSON sample response [full]

[["309542000","9252307","370190","34.327500","32.898000","119","91","92","0","2017-02-14T15:15:27","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","-1","34530","2003","Oil Products Tanker","Tanker","","ODESSA","2017-02-06T12:53:00","LIMASSOL","2017-02-14T20:00:00","118","","","","124","UAODS","UA","270","CYLMS","LIMASSOL","CY","2017-02-14T17:25:00","2017-02-14T15:08:00","22"],
["374886000","9647461","992387","36.743010","24.156150","192","157","157","0","2017-02-14T15:15:18","TER","19","MSC HAMBURG","70","3FYY8","PA","399","54","176490","0","186766","2015","Container Ship","Cargo","","PIRAEUS","2017-02-14T10:47:00","SUEZ","2017-02-15T20:59:00","156","","","","1","GRPIR","GR","17181","EGSUZ","SUEZ CANAL","EG","2017-02-16T00:05:00","2017-02-14T15:14:00","617">]]

JSON object sample response [simple]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42"}]

JSON object sample response [extended]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN","SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG","SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo"}]

JSON object sample response [full]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN" ,"SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker","CURRENT_PORT":","LAST_PORT":ODESSA","LAST_PORT_TIME":2017-02-06T12:53:00","DESTINATION":LIMASSOL","ETA":2017-02-14T20:00:00","DRAUGHT":118","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":124","LAST_PORT_UNLOCODE":UAODS","LAST_PORT_COUNTRY":UA","NEXT_PORT_ID":270","NEXT_PORT_UNLOCODE":CYLMS","NEXT_PORT_NAME":LIMASSOL","NEXT_PORT_COUNTRY":CY","ETA_CALC":2017-02-14T17:18:00","ETA_UPDATED":2017-02-14T14:06:00","DISTANCE_TO_GO":27"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG" ,"SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo","CURRENT_PORT":","LAST_PORT":PIRAEUS","LAST_PORT_TIME":2017-02-14T10:47:00","DESTINATION":SUEZ","ETA":2017-02-15T20:59:00","DRAUGHT":156","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":1","LAST_PORT_UNLOCODE":GRPIR","LAST_PORT_COUNTRY":GR","NEXT_PORT_ID":17181","NEXT_PORT_UNLOCODE":EGSUZ","NEXT_PORT_NAME":SUEZ CANAL","NEXT_PORT_COUNTRY":EG","ETA_CALC":2017-02-15T21:14:00","ETA_UPDATED":2017-02-14T14:12:00","DISTANCE_TO_GO":27"}]

Version 8 (latest)

View other: Version 7

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT	integer	The year that the subject vessel was built
ROT	integer	Rate of Turn
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
CURRENT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED	real	The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED	real	The maximum speed reported by the subject vessel during the latest voyage (port to port)

Version 7

View other: Version 8 (latest)

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination

Description: Single Vessel Positions

Endpoint URL: https://services.marinetraffic.com/api/exportvessel/v:5

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	2	The maximum age, in minutes, of the returned positions. Maximum value is 2880.
msgtype	no	text	simple	If used with the value extended, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
mmsi	yes (only use one of the three)	integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track.
imo				The International Maritime Organization (IMO) number of the vessel you wish to track.
shipid				A uniquely assigned ID by MarineTraffic for the subject vessel.

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING values -1 or 511 indicate lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Typical API call:
https://services.marinetraffic.com/api/exportvessel/v:5/YOUR-API-KEY/timespan:#minutes/mmsi:value

Example API call:
https://services.marinetraffic.com/api/exportvessel/v:5/8205c862d0572op1655989d939f1496c092ksvs4/timespan:20/mmsi:310627000

XML sample response [simple]

<POS>
<row MMSI="240391000" LAT="37.463669" LON="25.32655" SPEED="0" HEADING="100" COURSE="146" STATUS="0" TIMESTAMP="2012-04-18T21:02:00" DSRC="SAT"/>
</POS>

XML sample response [extended]

<POS>
<row MMSI="205623000" LAT="37.24538" LON="25.590981" SPEED="65" HEADING="250" COURSE="288" STATUS="0" TIMESTAMP="2016-04-18T19:21:00" SHIPNAME="MALACHITE" SHIPTYPE="70" TYPE_NAME="Passengers Ship" AIS_TYPE_SUMMARY="Passenger" IMO="9549645" CALLSIGN="ONHL" FLAG="BE" PORT_ID=""PORT_UNLOCODE=""CURRENT_PORT=""LAST_PORT_ID="768"LAST_PORT_UNLOCODE="AUFRE" LAST_PORT="FREMANTLE""LAST_PORT_TIME="2016-04-16T18:26:00" DESTINATION="DERINCE" ETA="2017-04-20T14:00:00" ETA_CALC="2017-05-20T14:00:00"LENGTH="90" WIDTH="14" DRAUGHT="50" GRT="3517" NEXT_PORT_ID="890"NEXT_PORT_UNLOCODE="AUADL"NEXT_PORT_NAME="ADELAIDE" NEXT_PORT_COUNTRY="AU" DWT="5000" YEAR_BUILT="2012" DSRC="SAT"/>
</POS>

CSV sample response [simple]

MMSI, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC
310627000,-35.564580,126.044800,226,89,89,0,2017-02-14T16:14:00,SAT

CSV sample response [extended]

MMSI, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, SHIPNAME, SHIPTYPE, TYPE_NAME, AIS_TYPE_SUMMARY, IMO, CALLSIGN, FLAG, PORT_ID, PORT_UNLOCODE, CURRENT_PORT, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, ETA_CALC, LENGTH, WIDTH, DRAUGHT, GRT, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, DWT, YEAR_BUILT, DSRC
310627000,-35.564580,126.044800,226,89,89,0,2017-02-14T16:14:00,QUEEN MARY 2,60,Passengers Ship,Passenger,9241061,ZCEF6,BM,,,,768,AUFRE,FREMANTLE,2017-02-12T12:47:00,ADELAIDE,2017-02-15T23:00:00,2017-02-15T21:30:00,345.03,48.7,103,148528,890,AUADL,ADELAIDE,AU,19189,2002,SAT

Simplified JSON sample response [simple]

[[310627000","-35.564580","126.044800","226","89","89","0","2017-02-14T16:14:00","SAT"]]

Simplified JSON sample response [extended]

[["310627000","-35.564580","126.044800","226","89","89","0","2017-02-14T16:14:00","QUEEN MARY 2","60","Passengers Ship","Passenger","9241061","ZCEF6","BM","","","","768","AUFRE","FREMANTLE","2017-02-12T12:47:00","ADELAIDE","2017-02-15T23:00:00","2017-02-15T21:30:00","345.03","48.7","103","148528","890","AUADL","ADELAIDE","AU","19189","2002","SAT"]]

JSON object sample response [simple]

[{"MMSI":"240391000","LAT":"37.463669","LON":"25.32655","SPEED":"0","HEADING":"100","COURSE":"146","STATUS":"0","TIMESTAMP":"2012-04-18T21:02:00","DSRC":"SAT"}]

Simplified JSON sample response [extended]

[{"MMSI":"205623000","LAT":"37.24538","LON":"25.590981","SPEED":"65","HEADING":"250","COURSE":"288","STATUS":"0","TIMESTAMP":"2016-04-18T19:21:00","SHIPNAME":"MALACHITE","SHIPTYPE":"70","TYPE_NAME":"Passengers Ship","AIS_TYPE_SUMMARY":"Passenger","IMO":"9549645","CALLSIGN":"ONHL","FLAG":"BE","PORT_ID":"","PORT_UNLOCODE":"","CURRENT_PORT":"","LAST_PORT_ID":"768","LAST_PORT_UNLOCODE":"AUFRE","LAST_PORT":"FREMANTLE","LAST_PORT_TIME":"2016-04-16T18:26:00","DESTINATION":"DERINCE","ETA":"2017-04-20T14:00:00","ETA_CALC":"2017-05-20T14:00:00","LENGTH":"90","WIDTH":"14","DRAUGHT":"50","GRT":"3517","NEXT_PORT_ID":"890","NEXT_PORT_UNLOCODE":"AUADL","NEXT_PORT_NAME":"ADELAIDE","NEXT_PORT_COUNTRY":"AU","DWT":"5000","YEAR_BUILT":"2012","DSRC":"SAT"}]

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID

Description: Vessel Positions in a Custom Area

Endpoint URL: https://services.marinetraffic.com/api/exportvessels-custom-area

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	5	The maximum age, in minutes, of the returned positions. Maximum value is 2880.
msgtype	no	text	simple	If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
shiptype_generic	no	integer		Filter vessels based on generic vessel types, comma separated values supported Vessel type ID should be used and not vessel type name (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker) Should not be combined with shiptype_detailed filter
shiptype_detailed	no	integer		Filter vessels based on detailed vessel types, comma separated values supported Vessel type ID should be used and not vessel type name - more Should not be combined with shiptype_generic filter

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING and COURSE value NULL indicates lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Typical API call:
https://services.marinetraffic.com/api/exportvessels-custom-area/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels-custom-area/8205c862d0572op1655989d939f1496c092ksvs4/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54"/>
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369" DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker"  DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo"  DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" />
</pos>

XML sample response [full]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369"  DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" CURRENT_PORT="" LAST_PORT="BILBAO ANCH" LAST_PORT_TIME="2017-05-16T15:37:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="20648" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" NEXT_PORT_ID="251" NEXT_PORT_UNLOCODE="IEGRN" NEXT_PORT_NAME="GREENORE" NEXT_PORT_COUNTRY="IE" ETA_CALC="2017-05-21T09:55:00" ETA_UPDATED="2017-05-19T09:07:00" DISTANCE_TO_GO="407"  DISTANCE_TRAVELLED="364"  AVG_SPEED="8.5"  MAX_SPEED="8.80000019"  />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker" DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" CURRENT_PORT="" LAST_PORT="HAMBURG" LAST_PORT_TIME="2017-05-16T15:04:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="172" LAST_PORT_UNLOCODE="DEHAM" LAST_PORT_COUNTRY="DE" NEXT_PORT_ID="1271" NEXT_PORT_UNLOCODE="ESBIO" NEXT_PORT_NAME="BILBAO" NEXT_PORT_COUNTRY="ES" ETA_CALC="2017-05-20T11:27:00" ETA_UPDATED="2017-05-19T09:13:00" DISTANCE_TO_GO="295"  DISTANCE_TRAVELLED="782"  AVG_SPEED="12"  MAX_SPEED="13.3999996"   />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.926899" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" CURRENT_PORT="" LAST_PORT="BAYONNE" LAST_PORT_TIME="2017-05-17T16:05:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="508" LAST_PORT_UNLOCODE="FRBAY" LAST_PORT_COUNTRY="FR" NEXT_PORT_ID="500" NEXT_PORT_UNLOCODE="FRSML" NEXT_PORT_NAME="SAINT MALO" NEXT_PORT_COUNTRY="FR" ETA_CALC="2017-05-20T09:11:00" ETA_UPDATED="2017-05-19T09:43:00" DISTANCE_TO_GO="183"  DISTANCE_TRAVELLED="333"  AVG_SPEED="7.80000019"  MAX_SPEED="8.5"   />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52

CSV sample response [extended]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00

CSV sample response [full]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00,,BILBAO ANCH,2017-05-16T15:37:00,,,,20648,,ES,251,IEGRN,GREENORE,IE,2017-05-21T09:55:00,2017-05-19T09:07:00,407,364,8.5,8.80000019
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00,,HAMBURG,2017-05-16T15:04:00,,,,172,DEHAM,DE,1271,ESBIO,BILBAO,ES,2017-05-20T11:27:00,2017-05-19T09:13:00,295,782,12,13.3999996
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00,,BAYONNE,2017-05-17T16:05:00,,,,508,FRBAY,FR,500,FRSML,SAINT MALO,FR,2017-05-20T09:11:00,2017-05-19T09:43:00,183,333,7.80000019,8.5

Simplified JSON sample response [simple]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52"]]

Simplified JSON sample response [extended]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00"]]

Simplified JSON sample response [full]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00","","BILBAO ANCH","2017-05-16T15:37:00","","","","20648","","ES","251","IEGRN","GREENORE","IE","2017-05-21T09:55:00","2017-05-19T09:07:00","407","364","8.5","8.80000019"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00","","HAMBURG","2017-05-16T15:04:00","","","","172","DEHAM","DE","1271","ESBIO","BILBAO","ES","2017-05-20T11:27:00","2017-05-19T09:13:00","295","782","12","13.3999996"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00","","BAYONNE","2017-05-17T16:05:00","","","","508","FRBAY","FR","500","FRSML","SAINT MALO","FR","2017-05-20T09:11:00","2017-05-19T09:43:00","183","333","7.80000019","8.5"]

JSON object sample response [simple]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52"}]

JSON object sample response [extended]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00"}]

JSON object sample response [full]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00","CURRENT_PORT":"","LAST_PORT":"BILBAO ANCH","LAST_PORT_TIME":"2017-05-16T15:37:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"20648","LAST_PORT_UNLOCODE":"","LAST_PORT_COUNTRY":"ES","NEXT_PORT_ID":"251","NEXT_PORT_UNLOCODE":"IEGRN","NEXT_PORT_NAME":"GREENORE","NEXT_PORT_COUNTRY":"IE","ETA_CALC":"2017-05-21T09:55:00","ETA_UPDATED":"2017-05-19T09:07:00","DISTANCE_TO_GO":"407","DISTANCE_TRAVELLED":"364","AVG_SPEED":"8.5","MAX_SPEED":"8.80000019"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00","CURRENT_PORT":"","LAST_PORT":"HAMBURG","LAST_PORT_TIME":"2017-05-16T15:04:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"172","LAST_PORT_UNLOCODE":"DEHAM","LAST_PORT_COUNTRY":"DE","NEXT_PORT_ID":"1271","NEXT_PORT_UNLOCODE":"ESBIO","NEXT_PORT_NAME":"BILBAO","NEXT_PORT_COUNTRY":"ES","ETA_CALC":"2017-05-20T11:27:00","ETA_UPDATED":"2017-05-19T09:13:00","DISTANCE_TO_GO":"295","DISTANCE_TRAVELLED":"782","AVG_SPEED":"12","MAX_SPEED":"13.3999996"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00","CURRENT_PORT":"","LAST_PORT":"BAYONNE","LAST_PORT_TIME":"2017-05-17T16:05:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"508","LAST_PORT_UNLOCODE":"FRBAY","LAST_PORT_COUNTRY":"FR","NEXT_PORT_ID":"500","NEXT_PORT_UNLOCODE":"FRSML","NEXT_PORT_NAME":"SAINT MALO","NEXT_PORT_COUNTRY":"FR","ETA_CALC":"2017-05-20T09:11:00","ETA_UPDATED":"2017-05-19T09:43:00","DISTANCE_TO_GO":"183","DISTANCE_TRAVELLED":"333","AVG_SPEED":"7.80000019","MAX_SPEED":"8.5"}]

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT	integer	The year that the subject vessel was built
ROT	integer	Rate of Turn
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
CURRENT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED	real	The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED	real	The maximum speed reported by the subject vessel during the latest voyage (port to port)

Description: Port Calls

Endpoint URL: https://services.marinetraffic.com/api/portcalls/v:4

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	2	The maximum age, in minutes, of the returned port calls. Maximum value is 2880.
msgtype	no	text	simple	If used with the value extended, the response includes voyage related data since the previous port call.
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
portid	yes (only use one of the four)	integer/text		The MarineTraffic ID of the port you wish to monitor (found on the URL of the respective Port page) or port UN/LOCODE.
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.
shipid		integer		A uniquely assigned ID by MarineTraffic for the subject vessel.
movetype	no	integer		Use 0 to only receive arrivals or 1 to only receive departures. If not used, the response will include both.
exclude_intransit	no	integer	0	Use 1 to exclude vessels in transit
fromdate	no (use both)	datetime		Portcalls between fromdate and todate. Date format: YYYY-MM-DD HH:MM
todate	no (use both)	datetime
dwt_min	no	integer		Data filter: minimum DWT applicable to IMO-having vessels
dwt_max	no	integer		Data filter: maximum DWT applicable to IMO-having vessels
gt_min	no	integer		Data filter: minimum GT applicable to IMO-having vessels
gt_max	no	integer		Data filter: maximum GT applicable to IMO-having vessels

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
MOVE_TYPE values: 1=Departure, 0=Arrival

Typical API call:
https://services.marinetraffic.com/api/portcalls/v:4/YOUR-API-KEY/portid:value/timespan:#minutes

Example API call:
https://services.marinetraffic.com/api/portcalls/v:4/8205c862d0572op1655989d939f1496c092ksvs4/portid:1/gt_min:4000/dwt_min:9000/timespan:60

XML sample response [simple]

<PORTCALLS>
<PORTCALL MMSI="566312000" SHIPNAME="MARITIME KELLY ANNE" SHIP_ID="708694" TIMESTAMP_LT="2016-03-03T07:10:00" TIMESTAMP_UTC="2016-03-03T12:10:00" MOVE_TYPE="1" TYPE_NAME="Container Ship" PORT_ID="213" PORT_NAME="NEW ORLEANS"UNLOCODE="USMSY"/>
<PORTCALL MMSI="241188000" SHIPNAME="VERNICOS MERMAID" SHIP_ID="4947635" TIMESTAMP_LT="2016-03-03T06:42:00" TIMESTAMP_UTC="2016-03-03T12:20:00" MOVE_TYPE="0" TYPE_NAME="Tug" PORT_ID="1" PORT_NAME="PIRAEUS" UNLOCODE="GRPIR"/>
<PORTCALL MMSI="215896000" SHIPNAME="BAVARIA" SHIP_ID="756018" TIMESTAMP_LT="2016-03-04T00:01:00" TIMESTAMP_UTC="2016-03-03T13:01:00" MOVE_TYPE="0" TYPE_NAME="Container Ship" PORT_ID="110" PORT_NAME="BOTANY" UNLOCODE="AUBTB"/>
</PORTCALLS>

XML sample response [extended]

<PORTCALLS>
<PORTCALL MMSI="566312000" SHIPNAME="MARITIME KELLY ANNE" SHIP_ID="708694" TIMESTAMP_LT="2016-03-03T07:10:00" TIMESTAMP_UTC="2016-03-03T12:10:00" MOVE_TYPE="1" TYPE_NAME="Container Ship" PORT_ID="213" PORT_NAME="NEW ORLEANS" UNLOCODE="USMSY" DRAUGHT="45" LOAD_STATUS="0" PORT_OPERATION="0" INTRANSIT="0"  DISTANCE_TRAVELLED=""  VOYAGE_SPEED_AVG="57"  VOYAGE_SPEED_MAX="73" VOYAGE_IDLE_TIME_MINS="0" ELAPSED_NOANCH="11" DISTANCE_LEG="1" COMFLEET_GROUPEDTYPE="WET BULK" SHIPCLASS="HANDYSIZE"/>
<PORTCALL MMSI="241188000" SHIPNAME="VERNICOS MERMAID" SHIP_ID="4947635"  TIMESTAMP_LT="2016-03-03T06:42:00" TIMESTAMP_UTC="2016-03-03T12:20:00" MOVE_TYPE="1" TYPE_NAME="Tug" PORT_ID="50" PORT_NAME="THESSALONIKI" UNLOCODE="GRPIR" DRAUGHT="45" LOAD_STATUS="0" PORT_OPERATION="0" INTRANSIT="0" DISTANCE_TRAVELLED="1" VOYAGE_SPEED_AVG="1"  VOYAGE_SPEED_MAX="0" VOYAGE_IDLE_TIME_MINS="0" ELAPSED_NOANCH="46" DISTANCE_LEG="" COMFLEET_GROUPEDTYPE="" SHIPCLASS=""/>
<PORTCALL MMSI="215896000" SHIPNAME="BAVARIA" SHIP_ID="756018"  TIMESTAMP_LT="2016-03-04T00:01:00"  TIMESTAMP_UTC="2016-03-03T13:01:00"  MOVE_TYPE="0" TYPE_NAME="Container Ship" PORT_ID="110" PORT_NAME="BOTANY" UNLOCODE="AUBTB" DRAUGHT="84" LOAD_STATUS="0" PORT_OPERATION="0" INTRANSIT="0" DISTANCE_TRAVELLED="206" VOYAGE_SPEED_AVG="119" VOYAGE_SPEED_MAX="145" VOYAGE_IDLE_TIME_MINS="0" ELAPSED_NOANCH="1035" DISTANCE_LEG="2" COMFLEET_GROUPEDTYPE="DRY BULK" SHIPCLASS="HANDYMAX"/>
</PORTCALLS>

CSV sample response [simple]

MMSI, SHIPNAME, SHIP_ID, TIMESTAMP_LT, TIMESTAMP_UTC, MOVE_TYPE, TYPE_NAME, PORT_ID, PORT_NAME,UNLOCODE
566312000,MARITIME KELLY ANNE,708694,2016-03-03T07:10:00,2016-03-03T12:10:00,0,Container Ship,213,NEW ORLEANS,USMSY
241188000,VERNICOS MERMAID,4947635,2016-03-03T06:42:00,2016-03-03T12:20:00,0,Tug,50,THESSALONIKI,GRPIR
1215896000,BAVARIA,756018,2016-03-04T00:01:00,2016-03-03T13:01:00,1,Container Ship,110,BOTANY,AUBTB

CSV sample response [extended]

MMSI, SHIPNAME, SHIP_ID, TIMESTAMP_LT, TIMESTAMP_UTC, MOVE_TYPE, TYPE_NAME, PORT_ID, PORT_NAME, UNLOCODE, DRAUGHT, LOAD_STATUS, PORT_OPERATION, INTRANSIT, DISTANCE_TRAVELLED, VOYAGE_SPEED_AVG, VOYAGE_SPEED_MAX, VOYAGE_IDLE_TIME_MINS, ELAPSED_NOANCH, DISTANCE_LEG, COMFLEET_GROUPEDTYPE, SHIPCLASS
566312000,MARITIME KELLY ANNE,708694,2016-03-03T07:10:00,2016-03-03T12:10:00,1,Container Ship,213,NEW ORLEANS,USMSY,45,0,0,0,0,57,73,0,11,1,WET BULK,HANDYSIZE
241188000,VERNICOS MERMAID,4947635,2016-03-03T06:42:00,2016-03-03T12:20:00,1,Tug,50,THESSALONIKI,GRSKG,45,0,0,0,1,1,0,0,46,,,,
215896000,BAVARIA,756018,2016-03-04T00:01:00,2016-03-03T13:01:00,2,0,Container Ship,110,BOTANY,AUBTB,84,0,0,0,206,119,145,0,1035,DRY BULK,HANDYMAX

Simplified JSON sample response [simple]

[["566312000","MARITIME KELLY ANNE","708694","2016-03-03T07:10:00","2016-03-03T12:10:00","0","Container Ship","213","NEW ORLEANS","USMSY"],
["241188000","VERNICOS MERMAID","4947635","2016-03-03T06:42:00","2016-03-03T12:20:00","0","Tug","50","THESSALONIKI","GRSKG"],
["215896000","BAVARIA","756018","2016-03-04T00:01:00","2016-03-03T13:01:00","1","Container Ship","110","BOTANY"]]

Simplified JSON sample response [extended]

[["566312000","MARITIME KELLY ANNE","708694","2016-03-03T07:10:00","2016-03-03T12:10:00","1","Container Ship","213","NEW ORLEANS","USMSY","45","0","0","0","0","57","73","0","11","1","WET BULK","HANDYSIZE"],
["241188000","VERNICOS MERMAID","4947635","2016-03-03T06:42:00","2016-03-03T12:20:00","1","Tug","50","THESSALONIKI","GRSKG","45","0","0","0","1","1","0","0","46","","",""],
["215896000","BAVARIA","756018","2016-03-04T00:01:00","2016-03-03T13:01:00","0","Container Ship","110","BOTANY","AUBTB","84","0","0","0","206","119","145","0","1035","2","DRY_BULK","HANDYMAX"]]

JSON object sample response [simple]

[{"MMSI":"566312000","SHIPNAME":"MARITIME KELLY ANNE","SHIP_ID":"708694","TIMESTAMP_LT":"2016-03-03T07:10:00","TIMESTAMP_UTC":"2016-03-03T12:10:00","MOVE_TYPE":"1","TYPE_NAME":"Container Ship","PORT_ID":"213","PORT_NAME":"NEW ORLEANS","UNLOCODE":"USMSY"},
{"MMSI":"241188000","SHIPNAME":"VERNICOS MERMAID","SHIP_ID":"4947635","TIMESTAMP_LT":"2016-03-03T06:42:00","TIMESTAMP_UTC":"2016-03-03T12:20:00","MOVE_TYPE":"0","TYPE_NAME":"Tug","PORT_ID":"1","PORT_NAME":"PIRAEUS","UNLOCODE":"GRSKG"},
{"MMSI":"215896000","SHIPNAME":"BAVARIA","SHIP_ID":"756018","TIMESTAMP_LT":"2016-03-04T00:01:00","TIMESTAMP_UTC":"2016-03-03T13:01:00","MOVE_TYPE":"0","TYPE_NAME":"Container Ship","PORT_ID":"110","PORT_NAME":"BOTANY","UNLOCODE":"AUBTB"}]

JSON object sample response [extended]

[{"MMSI":"566312000","SHIPNAME":"MARITIME KELLY ANNE","SHIP_ID":"708694","TIMESTAMP_LT":"2016-03-03T07:10:00","TIMESTAMP_UTC":"2016-03-03T12:10:00","MOVE_TYPE":"1","TYPE_NAME":"Container Ship","PORT_ID":"213","PORT_NAME":"NEW ORLEANS","UNLOCODE":"USMSY","DRAUGHT":"45","LOAD_STATUS":"0","PORT_OPERATION":"0","INTRANSIT":"0","VOYAGE_SPEED_AVG":"57","VOYAGE_SPEED_MAX":"73","VOYAGE_IDLE_TIME_MINS":"0","ELAPSED_NOANCH":"11"},
{"MMSI":"241188000","SHIPNAME":"VERNICOS MERMAID","SHIP_ID":"4947635","TIMESTAMP_LT":"2016-03-03T06:42:00","TIMESTAMP_UTC":"2016-03-03T12:20:00","MOVE_TYPE":"1","TYPE_NAME":"Tug","PORT_ID":"50","PORT_NAME":"THESSALONIKI","DRAUGHT":"45","LOAD_STATUS":"0","PORT_OPERATION":"0","INTRANSIT":"0","DISTANCE_TRAVELLED":"1","VOYAGE_SPEED_AVG":"1","VOYAGE_SPEED_MAX":"0","VOYAGE_IDLE_TIME_MINS":"0","ELAPSED_NOANCH":"46","UNLOCODE":"GRSKG"},
{"MMSI":"215896000","SHIPNAME":"BAVARIA","SHIP_ID":"756018","TIMESTAMP_LT":"2016-03-04T00:01:00","TIMESTAMP_UTC":"2016-03-03T13:01:00","MOVE_TYPE":"0","TYPE_NAME":"Container Ship","PORT_ID":"110","PORT_NAME":"BOTANY","UNLOCODE":"AUBTB","DRAUGHT":"84","LOAD_STATUS":"0","PORT_OPERATION":"0","INTRANSIT":"0","DISTANCE_TRAVELLED":"206","VOYAGE_SPEED_AVG":"119","VOYAGE_SPEED_MAX":"145","VOYAGE_IDLE_TIME_MINS":"0","ELAPSED_NOANCH":"1035"}]

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
SHIPNAME	text	The Shipname of the subject vessel
SHIP_ID	text	A uniquely assigned ID by MarineTraffic for the subject vessel
TIMESTAMP_LT	date	The Date and Time (in Local Time) of the Port Call
TIMESTAMP_UTC	date	The Date and Time (in UTC) of the Port Call
MOVE_TYPE	integer	0 or 1 - specifies the Port Call type (0 = Arrival, 1 = Departure)
TYPE_NAME	text	The Type of the subject vessel
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_NAME	text	The Name of the subject Port
UNLOCODE	text	A uniquely assigned ID by United Nations for the subject Port

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
LOAD_STATUS	integer	The load status of the subject vessel (0 : N/A, 1 : In Ballast, 2 : Partially Laden, 3 : Fully Laden)
PORT_OPERATION	integer	Indicates LOAD/DISCHARGE operations in the subject Port Call event (0 : N/A, 1 : load, 2 : discharge, 3 : both, 4 : none)
INTRANSIT	integer	0 or 1 - specifies whether the vessel anchored in the Port or was In Transit (1 = In Transit)
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
VOYAGE_SPEED_AVG	integer	Average Maintained Speed (in knots x10) since the last Port Call while steaming at speed > 5 knots - Updated upon Arrival
VOYAGE_SPEED_MAX	integer	Maximum Recorded Speed (in knots x10) since the last Port Call - Updated upon Arrival
VOYAGE_IDLE_TIME_MINS	integer	Total time in minutes since the previous Port Call while the vessel stopped or moving at speed < 3 knots - Updated upon Arrival
ELAPSED_NOANCH	integer	Total time of Voyage since the previous Port Call except Anchorages and Canals - Updated upon Arrival
DISTANCE_LEG	integer	The distance (in NM) between the last two calls regardless of Port Type
COMFLEET_GROUPEDTYPE	text	The commercial market segment the subject vessel belongs to
SHIPCLASS	text	The class of the subject vessel based on vessel type and size

Note:

The data fields LOAD_STATUS and PORT_OPERATION are only available after 2017-10-01 (YYYY-MM-DD).

Description: Vessel Historical Track

Endpoint URL: https://services.marinetraffic.com/api/exportvesseltrack/v:3

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
msgtype	no	text	simple	If used with the value extended, the response includes also weather data.
days	yes (use days OR fromdate and todate)	integer		The number of days, starting from the time of request and going backwards, for which the response should look for position data. Maximum value is 190 (days).
fromdate		datetime		Date format: YYYY-MM-DD HH:MM:SS. If absent, current date will be selected.
todate		datetime
mmsi	yes (only use one of the three)	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.
shipid		integer		A uniquely assigned ID by MarineTraffic for the subject vessel.
period	no	text		Possible values: hourly: In order to receive hourly vessel positions daily: In order to receive daily vessel positions
MINLAT	no (use as a group)	float		Define an area for which you wish to either get all the historical vessels' positions or historical positions for a specific vessel. Important! If you do not define a vessel, the maximum period for which you can look back has a maximum period of one day. The absolute value of MAXLAT - MINLAT + MAXLON - MINLON has to be equal to or less than 2
MAXLAT
MINLON
MAXLON
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)

Notes

Ensure your client or library is configured to handle redirects
SPEED returned in (knots x10) and TIMESTAMP in UTC
Information about AIS-transmitted data
Hourly and daily records are the first records received during the hour or the day respectively
When the msgtype is extended, only on the first row of each hour the weather-related data fields return values
When the period is hourly, the data field HEADING is not available for positions older than 2017-11-17
Hourly records are available for dates after 2014-08-28
Weather data for winds are available for dates after 2015-05-27
Weather data for waves, swells and currents are available for dates after 2021-01-21

Version 3

Typical API call:
https://services.marinetraffic.com/api/exportvesseltrack/YOUR-API-KEY/v:3/period:value/days:value/mmsi:value

Example API call:
https://services.marinetraffic.com/api/exportvesseltrack/8205c862d0572op1655989d939f1496c092ksvs4/v:3/period:daily/days:3/mmsi:241486000

XML sample response [simple]

        <VESSELTRACK>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.904260" LAT="34.485870" COURSE="189" HEADING="190" TIMESTAMP="2017-07-12T10:06:00" SHIP_ID="4910653"/>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.901590" LAT="34.498680" COURSE="190" HEADING="191" TIMESTAMP="2017-07-13T10:02:00" SHIP_ID="4910653"/>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.895480" LAT="34.526649" COURSE="190" HEADING="191" TIMESTAMP="2017-07-14T09:55:00" SHIP_ID="4910653"/>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.893820" LAT="34.534679" COURSE="189" HEADING="191" TIMESTAMP="2017-07-15T09:52:00" SHIP_ID="4910653"/>
        </VESSELTRACK>

XML sample response [extended]

        <VESSELTRACK>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.904260" LAT="34.485870" COURSE="189" HEADING="190" TIMESTAMP="2017-07-12T10:06:00" SHIP_ID="4910653" WIND_ANGLE="340" WIND_SPEED="18" WIND_TEMP="12" SIGNIFICANT_WAVE_HEIGHT="7" WIND_WAVE_HEIGHT="1" WIND_WAVE_PERIOD="14" WIND_WAVE_DIRECTION="238" SWELL_HEIGHT="7" SWELL_PERIOD="49" SWELL_DIRECTION="238" CURRENTS_ANGLE="60" CURRENTS_SPEED="9"/>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.901590" LAT="34.498680" COURSE="190" HEADING="191" TIMESTAMP="2017-07-13T10:02:00" SHIP_ID="4910653" WIND_ANGLE="17" WIND_SPEED="14" WIND_TEMP="11" SIGNIFICANT_WAVE_HEIGHT="8" WIND_WAVE_HEIGHT="5" WIND_WAVE_PERIOD="16" WIND_WAVE_DIRECTION="245" SWELL_HEIGHT="4" SWELL_PERIOD="46" SWELL_DIRECTION="238" CURRENTS_ANGLE="320" CURRENTS_SPEED="9"/>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.895480" LAT="34.526649" COURSE="190" HEADING="191" TIMESTAMP="2017-07-14T09:55:00" SHIP_ID="4910653" WIND_ANGLE="99" WIND_SPEED="18" WIND_TEMP="13" SIGNIFICANT_WAVE_HEIGHT="4" WIND_WAVE_HEIGHT="0" WIND_WAVE_PERIOD="14" WIND_WAVE_DIRECTION="38" SWELL_HEIGHT="7" SWELL_PERIOD="33" SWELL_DIRECTION="140" CURRENTS_ANGLE="120" CURRENTS_SPEED="9"/>
        <POSITION MMSI="241486000" IMO="9761346" STATUS="0" SPEED="146" LON="-11.893820" LAT="34.534679" COURSE="189" HEADING="191" TIMESTAMP="2017-07-15T09:52:00" SHIP_ID="4910653" WIND_ANGLE="105" WIND_SPEED="18" WIND_TEMP="14" SIGNIFICANT_WAVE_HEIGHT="2" WIND_WAVE_HEIGHT="3" WIND_WAVE_PERIOD="11" WIND_WAVE_DIRECTION="150" SWELL_HEIGHT="4" SWELL_PERIOD="29" SWELL_DIRECTION="138" CURRENTS_ANGLE="220" CURRENTS_SPEED="8"/>
        </VESSELTRACK>

CSV sample response [simple]

        MMSI, IMO, STATUS, SPEED, LON, LAT, COURSE, HEADING, TIMESTAMP, SHIP_ID
        241486000,9761346,0,146,-11.904260,34.485870,189,190,2017-07-12T10:06:00,4910653
        241486000,9761346,0,146,-11.901590,34.498680,190,191,2017-07-13T10:02:00,4910653
        241486000,9761346,0,146,-11.895480,34.526649,190,191,2017-07-14T09:55:00,4910653
        241486000,9761346,0,146,-11.893820,34.534679,189,191,2017-07-15T09:52:00,4910653

CSV sample response [extended]

        MMSI, IMO, STATUS, SPEED, LON, LAT, COURSE, HEADING, TIMESTAMP, SHIP_ID, WIND_ANGLE, WIND_SPEED, WIND_TEMP, SIGNIFICANT_WAVE_HEIGHT, WIND_WAVE_HEIGHT, WIND_WAVE_PERIOD, WIND_WAVE_DIRECTION, SWELL_HEIGHT, SWELL_PERIOD, SWELL_DIRECTION, CURRENTS_ANGLE, CURRENTS_SPEED
        241486000,9761346,0,146,-11.904260,34.485870,189,190,2017-07-12T10:06:00,4910653,340,18,12,7,1,14,238,7,49,238,60,9
        241486000,9761346,0,146,-11.901590,34.498680,190,191,2017-07-13T10:02:00,4910653,17,14,11,8,5,16,245,4,46,238,320,9
        241486000,9761346,0,146,-11.895480,34.526649,190,191,2017-07-14T09:55:00,4910653,99,18,13,4,0,14,38,7,33,140,120,9
        241486000,9761346,0,146,-11.893820,34.534679,189,191,2017-07-15T09:52:00,4910653,105,24,15,2,3,11,150,4,29,138,220,8

Simplified JSON sample response [simple]

        [["241486000","9761346","0","146","11.904260","34.485870","189","190","2017-07-12T10:06:00","4910653"],
        ["241486000","9761346","0","146","11.901590","34.498680","190","191","2017-07-13T10:02:00","4910653"],
        ["241486000","9761346","0","146","11.895480","34.526649","190","191","2017-07-14T09:55:00","4910653"],
        ["241486000","9761346","0","146","11.893820","34.534679","189","191","2017-07-15T09:52:00","4910653"]]

Simplified JSON sample response [extended]

        [["241486000","9761346","0","146","11.904260","34.485870","189","190","2017-07-12T10:06:00","4910653","340","18","12","7","1","14","238","7","49","238","60","9"],
        ["241486000","9761346","0","146","11.901590","34.498680","190","191","2017-07-13T10:02:00","4910653","17","14","11","8","5","16","245","4","46","238","320","9"],
        ["241486000","9761346","0","146","11.895480","34.526649","190","191","2017-07-14T09:55:00","4910653","99","18","13","4","0","14","38","7","33","140","120","9"],
        ["241486000","9761346","0","146","11.893820","34.534679","189","191","2017-07-15T09:52:00","4910653","105","24","15","2",3","11","150","4","29","138","220","8"]]

JSON object sample response [simple]

[{"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.904260","LAT":"34.485870","COURSE":"189","HEADING":"190","TIMESTAMP":"2017-07-12T10:06:00","SHIP_ID":"4910653"},
        {"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.901590","LAT":"34.498680","COURSE":"190","HEADING":"191","TIMESTAMP":"2017-07-13T10:02:00","SHIP_ID":"4910653"},
        {"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.895480","LAT":"34.526649","COURSE":"190","HEADING":"191","TIMESTAMP":"2017-07-14T09:55:00","SHIP_ID":"4910653"},
        {"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.893820","LAT":"34.534679","COURSE":"189","HEADING":"191","TIMESTAMP":"2017-07-15T09:52:00","SHIP_ID":"4910653"}]

JSON object sample response [extended]

[{"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.904260","LAT":"34.485870","COURSE":"189","HEADING":"190","TIMESTAMP":"2017-07-12T10:06:00","SHIP_ID":"4910653","WIND_ANGLE":"340","WIND_SPEED":"18","WIND_TEMP":"12","SIGNIFICANT_WAVE_HEIGHT":"7","WIND_WAVE_HEIGHT":"1","WIND_WAVE_PERIOD":"14","WIND_WAVE_DIRECTION":"238","SWELL_HEIGHT":"7","SWELL_PERIOD":"49","SWELL_DIRECTION":"238","CURRENTS_ANGLE":"60","CURRENTS_SPEED":"9"},
        {"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.901590","LAT":"34.498680","COURSE":"190","HEADING":"191","TIMESTAMP":"2017-07-13T10:02:00","SHIP_ID":"4910653","WIND_ANGLE":"17","WIND_SPEED":"14","WIND_TEMP":"11","SIGNIFICANT_WAVE_HEIGHT":"8","WIND_WAVE_HEIGHT":"5","WIND_WAVE_PERIOD":"16","WIND_WAVE_DIRECTION":"245","SWELL_HEIGHT":"4","SWELL_PERIOD":"46","SWELL_DIRECTION":"238","CURRENTS_ANGLE":"320","CURRENTS_SPEED":"9"},
        {"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.895480","LAT":"34.526649","COURSE":"190","HEADING":"191","TIMESTAMP":"2017-07-14T09:55:00","SHIP_ID":"4910653","WIND_ANGLE":"99","WIND_SPEED":"18","WIND_TEMP":"13"," SIGNIFICANT_WAVE_HEIGHT":"4"," WIND_WAVE_HEIGHT":"0"," WIND_WAVE_PERIOD":"14"," WIND_WAVE_DIRECTION":"38"," SWELL_HEIGHT":"7"," SWELL_PERIOD":"33"," SWELL_DIRECTION":"140"," CURRENTS_ANGLE":"120"," CURRENTS_SPEED":"9"},
        {"MMSI":"241486000","IMO":"9761346","STATUS":"0","SPEED":"146","LON":"11.893820","LAT":"34.534679","COURSE":"189","HEADING":"191","TIMESTAMP":"2017-07-15T09:52:00","SHIP_ID":"4910653","WIND_ANGLE":"105","WIND_SPEED":"24","WIND_TEMP":"15","SIGNIFICANT_WAVE_HEIGHT":"2","WIND_WAVE_HEIGHT":"3","WIND_WAVE_PERIOD":"11","WIND_WAVE_DIRECTION":"150","SWELL_HEIGHT":"4","SWELL_PERIOD":"29","SWELL_DIRECTION":"138","CURRENTS_ANGLE":"220","CURRENTS_SPEED":"8"}]

Version 3

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
WIND_ANGLE	integer	The angle of the wind in the subject area (in degrees, compared to True North)
WIND_SPEED	integer	The speed of the wind in the subject area (in knots)
WIND_TEMP	integer	The temperature of the wind in the subject area (in Celsius degrees)
SIGNIFICANT_WAVE_HEIGHT	integer	The significant wave height in the subject area (in meters x10)
WIND_WAVE_HEIGHT	integer	The height of the wind waves in the subjects area (in meters x10)
WIND_WAVE_PERIOD	integer	The period of the wind waves in the subject area (in seconds)
WIND_WAVE_DIRECTION	integer	The direction of the wind waves in the subject area (in degrees, compared to True North)
SWELL_HEIGHT	integer	The height of the swells in the subject area (in meters x10)
SWELL_PERIOD	integer	The period of the swells in the subject area (in seconds)
SWELL_DIRECTION	integer	The direction of the swells in the subject area (in degrees, compared to True North)
CURRENTS_ANGLE	integer	The angle of the currents in the subject area (in degrees, compared to True North)
CURRENTS_SPEED	integer	The speed of the currents in the subject area (in knots x100)

Description: Vessel Photos

Endpoint URL: https://services.marinetraffic.com/api/exportvesselphoto

Parameters

Parameter name	Required?	Type	Description
[no name]	yes	text	API key: 40-character hexadecimal number
vessel_id	yes (use one of the two)	integer	The Maritime Mobile Service Identity (MMSI) or the IMO number of the vessel.
shipid	yes (use one of the two)	integer	A uniquely assigned ID by MarineTraffic for the subject vessel.

Notes

Ensure your client or library is configured to handle redirects

Typical API call:
https://services.marinetraffic.com/api/exportvesselphoto/YOUR-API-KEY/vessel_id:value

Example API call:
https://services.marinetraffic.com/api/exportvesselphoto/8205c862d0572op1655989d939f1496c092ksvs4/vessel_id:310627000

XML sample response

<photo>
<PHOTOURL URL="https://services.marinetraffic.com/photos/show/864354" />
</photo>

Simple response

Field Name	Data Type	Description
URL	text	The URL of the photo

Description: Vessel Positions in a Dynamic Bounding Box

Endpoint URL: https://services.marinetraffic.com/api/exportvessels/v:8

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	5	The maximum age, in minutes, of the returned positions. Maximum value is 2880.
msgtype	no	text	simple	If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms). If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19).
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
MINLAT	yes	float		Use as a group
MAXLAT
MINLON
MAXLON
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
HEADING values -1 or 511 indicate lack of data
SPEED and COURSE values for base stations are represented by zero (0)
More information about response parameters: STATUS , SHIPTYPE

Click here to read the examples of previous version (v:7)

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/MINLAT:value/MAXLAT:value/MINLON:value/MAXLON:value/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:8/8205c862d0572op1655989d939f1496c092ksvs4/MINLAT:38.20882/MAXLAT:40.24562/MINLON:-6.7749/MAXLON:-4.13721/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54"/>
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369" DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker"  DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.942631" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo"  DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" />
</pos>

XML sample response [full]

<pos>
<row MMSI="304010417" IMO="9015462" SHIP_ID="359396" LAT="47.758499" LON="-5.154223" SPEED="74" HEADING="329" COURSE="327" STATUS="0" TIMESTAMP="2017-05-19T09:39:57" DSRC="TER" UTC_SECONDS="54" SHIPNAME="DORNUM"  SHIPTYPE="70" CALLSIGN="V2OZ" FLAG="AG" LENGTH="81.7900009" WIDTH="11.3000002" GRT="1662" DWT="2369"  DRAUGHT="44" YEAR_BUILT="1993" ROT="6" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="GREENORE" ETA="2017-05-20T08:00:00" CURRENT_PORT="" LAST_PORT="BILBAO ANCH" LAST_PORT_TIME="2017-05-16T15:37:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="20648" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" NEXT_PORT_ID="251" NEXT_PORT_UNLOCODE="IEGRN" NEXT_PORT_NAME="GREENORE" NEXT_PORT_COUNTRY="IE" ETA_CALC="2017-05-21T09:55:00" ETA_UPDATED="2017-05-19T09:07:00" DISTANCE_TO_GO="407"  DISTANCE_TRAVELLED="364"  AVG_SPEED="8.5"  MAX_SPEED="8.80000019"  />
<row MMSI="215819000" IMO="9034731" SHIP_ID="150559" LAT="47.926899" LON="-5.531450" SPEED="122" HEADING="162" COURSE="157" STATUS="0" TIMESTAMP="2017-05-19T09:44:27" DSRC="TER" UTC_SECONDS="28" SHIPNAME="TOUR MARGAUX"  SHIPTYPE="81" CALLSIGN="9HBW8" FLAG="MT" LENGTH="113.639999" WIDTH="17.7000008" GRT="5499" DWT="8674" DRAUGHT="64" YEAR_BUILT="1993" ROT="0" TYPE_NAME="Oil/Chemical Tanker" AIS_TYPE_SUMMARY="Tanker" DESTINATION="BILBAO" ETA="2017-05-20T16:00:00" CURRENT_PORT="" LAST_PORT="HAMBURG" LAST_PORT_TIME="2017-05-16T15:04:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="172" LAST_PORT_UNLOCODE="DEHAM" LAST_PORT_COUNTRY="DE" NEXT_PORT_ID="1271" NEXT_PORT_UNLOCODE="ESBIO" NEXT_PORT_NAME="BILBAO" NEXT_PORT_COUNTRY="ES" ETA_CALC="2017-05-20T11:27:00" ETA_UPDATED="2017-05-19T09:13:00" DISTANCE_TO_GO="295"  DISTANCE_TRAVELLED="782"  AVG_SPEED="12"  MAX_SPEED="13.3999996"   />
<row MMSI="255925000" IMO="9184433" SHIP_ID="300518" LAT="47.926899" LON="-5.116510" SPEED="79" HEADING="316" COURSE="311" STATUS="0" TIMESTAMP="2017-05-19T09:43:53" DSRC="TER" UTC_SECONDS="52" SHIPNAME="BULNES"  SHIPTYPE="70" CALLSIGN="CQWC" FLAG="PT" LENGTH="85.6600037" WIDTH="13.0200005" GRT="2469" DWT="3700" DRAUGHT="58" YEAR_BUILT="2001" ROT="22" TYPE_NAME="General Cargo" AIS_TYPE_SUMMARY="Cargo" DESTINATION="SAINT MALO" ETA="2017-05-20T09:00:00" CURRENT_PORT="" LAST_PORT="BAYONNE" LAST_PORT_TIME="2017-05-17T16:05:00" CURRENT_PORT_ID="" CURRENT_PORT_UNLOCODE="" CURRRENT_PORT_COUNTRY="" LAST_PORT_ID="508" LAST_PORT_UNLOCODE="FRBAY" LAST_PORT_COUNTRY="FR" NEXT_PORT_ID="500" NEXT_PORT_UNLOCODE="FRSML" NEXT_PORT_NAME="SAINT MALO" NEXT_PORT_COUNTRY="FR" ETA_CALC="2017-05-20T09:11:00" ETA_UPDATED="2017-05-19T09:43:00" DISTANCE_TO_GO="183"  DISTANCE_TRAVELLED="333"  AVG_SPEED="7.80000019"  MAX_SPEED="8.5"   />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52

CSV sample response [extended]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00

CSV sample response [full]

MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED
304010417,9015462,359396,47.758499,-5.154223,74,329,327,0,2017-05-19T09:39:57,TER,54,DORNUM,70,V2OZ,AG,81.7900009,11.3000002,1662,2369,44,1993,6,General Cargo,Cargo,GREENORE,2017-05-20T08:00:00,,BILBAO ANCH,2017-05-16T15:37:00,,,,20648,,ES,251,IEGRN,GREENORE,IE,2017-05-21T09:55:00,2017-05-19T09:07:00,407,364,8.5,8.80000019
215819000,9034731,150559,47.926899,-5.531450,122,162,157,0,2017-05-19T09:44:27,TER,28,TOUR MARGAUX,81,9HBW8,MT,113.639999,17.7000008,5499,8674,64,1993,0,Oil/Chemical Tanker,Tanker,BILBAO,2017-05-20T16:00:00,,HAMBURG,2017-05-16T15:04:00,,,,172,DEHAM,DE,1271,ESBIO,BILBAO,ES,2017-05-20T11:27:00,2017-05-19T09:13:00,295,782,12,13.3999996
255925000,9184433,300518,47.942631,-5.116510,79,316,311,0,2017-05-19T09:43:53,TER,52,BULNES,70,CQWC,PT,85.6600037,13.0200005,2469,3700,58,2001,22,General Cargo,Cargo,SAINT MALO,2017-05-20T09:00:00,,BAYONNE,2017-05-17T16:05:00,,,,508,FRBAY,FR,500,FRSML,SAINT MALO,FR,2017-05-20T09:11:00,2017-05-19T09:43:00,183,333,7.80000019,8.5

Simplified JSON sample response [simple]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52"]]

Simplified JSON sample response [extended]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00"]]

Simplified JSON sample response [full]

[["304010417","9015462","359396","47.758499","-5.154223","74","329","327","0","2017-05-19T09:39:57","TER","54","DORNUM","70","V2OZ","AG","81.7900009","11.3000002","1662","2369","44","1993","6","General Cargo","Cargo","GREENORE","2017-05-20T08:00:00","","BILBAO ANCH","2017-05-16T15:37:00","","","","20648","","ES","251","IEGRN","GREENORE","IE","2017-05-21T09:55:00","2017-05-19T09:07:00","407","364","8.5","8.80000019"],
["215819000","9034731","150559","47.926899","-5.531450","122","162","157","0","2017-05-19T09:44:27","TER","28","TOUR MARGAUX","81","9HBW8","MT","113.639999","17.7000008","5499","8674","64","1993","0","Oil/Chemical Tanker","Tanker","BILBAO","2017-05-20T16:00:00","","HAMBURG","2017-05-16T15:04:00","","","","172","DEHAM","DE","1271","ESBIO","BILBAO","ES","2017-05-20T11:27:00","2017-05-19T09:13:00","295","782","12","13.3999996"],
["255925000","9184433","300518","47.942631","-5.116510","79","316","311","0","2017-05-19T09:43:53","TER","52","BULNES","70","CQWC","PT","85.6600037","13.0200005","2469","3700","58","2001","22","General Cargo","Cargo","SAINT MALO","2017-05-20T09:00:00","","BAYONNE","2017-05-17T16:05:00","","","","508","FRBAY","FR","500","FRSML","SAINT MALO","FR","2017-05-20T09:11:00","2017-05-19T09:43:00","183","333","7.80000019","8.5"]

JSON object sample response [simple]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52"}]

JSON object sample response [extended]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00"}]

JSON object sample response [full]

[{"MMSI":"304010417","IMO":"9015462","SHIP_ID":"359396","LAT":"47.758499","LON":"-5.154223","SPEED":"74","HEADING":"329","COURSE":"327","STATUS":"0","TIMESTAMP":"2017-05-19T09:39:57","DSRC":"TER","UTC_SECONDS":"54","SHIPNAME":"DORNUM","SHIPTYPE":"70","CALLSIGN":"V2OZ","FLAG":"AG","LENGTH":"81.7900009","WIDTH":"11.3000002","GRT":"1662","DWT":"2369","DRAUGHT":"44","YEAR_BUILT":"1993","ROT":"6","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"GREENORE","ETA":"2017-05-20T08:00:00","CURRENT_PORT":"","LAST_PORT":"BILBAO ANCH","LAST_PORT_TIME":"2017-05-16T15:37:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"20648","LAST_PORT_UNLOCODE":"","LAST_PORT_COUNTRY":"ES","NEXT_PORT_ID":"251","NEXT_PORT_UNLOCODE":"IEGRN","NEXT_PORT_NAME":"GREENORE","NEXT_PORT_COUNTRY":"IE","ETA_CALC":"2017-05-21T09:55:00","ETA_UPDATED":"2017-05-19T09:07:00","DISTANCE_TO_GO":"407","DISTANCE_TRAVELLED":"364","AVG_SPEED":"8.5","MAX_SPEED":"8.80000019"},
{"MMSI":"215819000","IMO":"9034731","SHIP_ID":"150559","LAT":"47.926899","LON":"-5.531450","SPEED":"122","HEADING":"162","COURSE":"157","STATUS":"0","TIMESTAMP":"2017-05-19T09:44:27","DSRC":"TER","UTC_SECONDS":"28","SHIPNAME":"TOUR MARGAUX","SHIPTYPE":"81","CALLSIGN":"9HBW8","FLAG":"MT","LENGTH":"113.639999","WIDTH":"17.7000008","GRT":"5499","DWT":"8674","DRAUGHT":"64","YEAR_BUILT":"1993","ROT":"0","TYPE_NAME":"Oil/Chemical Tanker","AIS_TYPE_SUMMARY":"Tanker","DESTINATION":"BILBAO","ETA":"2017-05-20T16:00:00","CURRENT_PORT":"","LAST_PORT":"HAMBURG","LAST_PORT_TIME":"2017-05-16T15:04:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"172","LAST_PORT_UNLOCODE":"DEHAM","LAST_PORT_COUNTRY":"DE","NEXT_PORT_ID":"1271","NEXT_PORT_UNLOCODE":"ESBIO","NEXT_PORT_NAME":"BILBAO","NEXT_PORT_COUNTRY":"ES","ETA_CALC":"2017-05-20T11:27:00","ETA_UPDATED":"2017-05-19T09:13:00","DISTANCE_TO_GO":"295","DISTANCE_TRAVELLED":"782","AVG_SPEED":"12","MAX_SPEED":"13.3999996"},
{"MMSI":"255925000","IMO":"9184433","SHIP_ID":"300518","LAT":"47.942631","LON":"-5.116510","SPEED":"79","HEADING":"316","COURSE":"311","STATUS":"0","TIMESTAMP":"2017-05-19T09:43:53","DSRC":"TER","UTC_SECONDS":"52","SHIPNAME":"BULNES","SHIPTYPE":"70","CALLSIGN":"CQWC","FLAG":"PT","LENGTH":"85.6600037","WIDTH":"13.0200005","GRT":"2469","DWT":"3700","DRAUGHT":"58","YEAR_BUILT":"2001","ROT":"22","TYPE_NAME":"General Cargo","AIS_TYPE_SUMMARY":"Cargo","DESTINATION":"SAINT MALO","ETA":"2017-05-20T09:00:00","CURRENT_PORT":"","LAST_PORT":"BAYONNE","LAST_PORT_TIME":"2017-05-17T16:05:00","CURRENT_PORT_ID":"","CURRENT_PORT_UNLOCODE":"","CURRENT_PORT_COUNTRY":"","LAST_PORT_ID":"508","LAST_PORT_UNLOCODE":"FRBAY","LAST_PORT_COUNTRY":"FR","NEXT_PORT_ID":"500","NEXT_PORT_UNLOCODE":"FRSML","NEXT_PORT_NAME":"SAINT MALO","NEXT_PORT_COUNTRY":"FR","ETA_CALC":"2017-05-20T09:11:00","ETA_UPDATED":"2017-05-19T09:43:00","DISTANCE_TO_GO":"183","DISTANCE_TRAVELLED":"333","AVG_SPEED":"7.80000019","MAX_SPEED":"8.5"}]

Version 7

Typical API call:
https://services.marinetraffic.com/api/exportvessels/v:7/YOUR-API-KEY/MINLAT:value/MAXLAT:value/MINLON:value/MAXLON:value/timespan:#minutes/protocol:value

Example API call:
https://services.marinetraffic.com/api/exportvessels/v:7/8205c862d0572op1655989d939f1496c092ksvs4/MINLAT:36.20882/MAXLAT:37.24562/MINLON:21.7749/MAXLON:23.13721/timespan:10/protocol:json

XML sample response [simple]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49"/>
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" />
</pos>

XML sample response [extended]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" />
</pos>

XML sample response [full]

<pos>
<row MMSI="309542000" IMO="9252307" SHIPID="370190" LAT="34.329670" LON="32.675670" SPEED="119" HEADING="89" COURSE="84" STATUS="0" TIMESTAMP="2017-02-14T14:19:48" DSRC="TER" UTC_SECONDS="49" SHIPNAME="MAERSK REMLIN"  SHIPTYPE="80" CALLSIGN="C6VT2" FLAG="BS" LENGTH="171.23" WIDTH="27.43" GRT="22184" DWT="34530" YEAR_BUILT="2003" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Tanker" CURRENT_PORT="" LAST_PORT="ODESSA" LAST_PORT_TIME="2017-02-06T12:53:00" DESTINATION="LIMASSOL" ETA="2017-02-14T20:00:00" DRAUGHT="118" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="124" LAST_PORT_UNLOCODE="UAODS" LAST_PORT_COUNTRY="UA" NEXT_PORT_ID="270" NEXT_PORT_UNLOCODE="CYLMS" NEXT_PORT_NAME="LIMASSOL" NEXT_PORT_COUNTRY="CY" ETA_CALC="2017-02-14T17:18:00" ETA_UPDATED="2017-02-14T14:06:00" DISTANCE_TO_GO="27" />
<row MMSI="374886000" IMO="9647461" SHIPID="992387" LAT="37.016960" LON="24.000240" SPEED="196" HEADING="155" COURSE="157" STATUS="0" TIMESTAMP="2017-02-14T14:18:41" DSRC="TER" UTC_SECONDS="42" SHIPNAME="MSC HAMBURG"  SHIPTYPE="70" CALLSIGN="3FYY8" FLAG="PA" LENGTH="399" WIDTH="54" GRT="176490" DWT="186766" YEAR_BUILT="2015" TYPE_NAME="Oil Products Tanker" AIS_TYPE_SUMMARY="Cargo" CURRENT_PORT="" LAST_PORT="PIRAEUS" LAST_PORT_TIME="2017-02-14T10:47:00" DESTINATION="SUEZ" ETA="2017-02-15T20:59:00" DRAUGHT="156" PORT_ID="" PORT_UNLOCODE="" PORT_COUNTRY="" LAST_PORT_ID="1" LAST_PORT_UNLOCODE="GRPIR" LAST_PORT_COUNTRY="GR" NEXT_PORT_ID="17181" NEXT_PORT_UNLOCODE="EGSUZ" NEXT_PORT_NAME="SUEZ CANAL" NEXT_PORT_COUNTRY="EG" ETA_CALC="2017-02-15T21:14:00" ETA_UPDATED="2017-02-14T14:12:00" DISTANCE_TO_GO="27" />
</pos>

CSV sample response [simple]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS
309542000,9252307,370190,34.328170,32.878170,119,91,92,0,2017-02-14T15:10:28,TER,29
374886000,9647461,992387,36.767090,24.143830,190,155,157,0,2017-02-14T15:10:24,TER,25

CSV sample response [extended]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY
309542000,9252307,370190,34.328500,32.862340,119,91,94,0,2017-02-14T15:06:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,34530,2003,Oil Products Tanker,Tanker
374886000,9647461,992387,36.783150,24.135430,193,156,156,0,2017-02-14T15:07:00,TER,60,MSC HAMBURG,70,3FYY8,PA,399,54,176490,186766,2015,Container Ship,Cargo

CSV sample response [full]

MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, ROT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, DRAUGHT, PORT_ID, PORT_UNLOCODE, PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO
309542000,9252307,370190,34.329170,32.846500,118,91,93,0,2017-02-14T15:02:28,TER,30,MAERSK REMLIN,80,C6VT2,BS,171.23,27.43,22184,-5,34530,2003,Oil Products Tanker,Tanker,,ODESSA,2017-02-06T12:53:00,LIMASSOL,2017-02-14T20:00:00,118,,,,124,UAODS,UA,270,CYLMS,LIMASSOL,CY,2017-02-14T17:18:00,2017-02-14T14:06:00,23
374886000,9647461,992387,36.800500,24.125940,191,157,158,0,2017-02-14T15:03:23,TER,25,MSC HAMBURG,70,3FYY8,PA,399,54,176490,0,186766,2015,Container Ship,Cargo,,PIRAEUS,2017-02-14T10:47:00,SUEZ,2017-02-15T20:59:00,156,,,,1,GRPIR,GR,17181,EGSUZ,SUEZ CANAL,EG,2017-02-15T21:14:00,2017-02-14T14:12:00,561

Simplified JSON sample response [simple]

[["309542000","9252307","370190","34.327840","32.886170","118","92","91","0","2017-02-14T15:12:28","TER","29"],
["374886000","9647461","992387","36.760870","24.147220","191","155","156","0","2017-02-14T15:11:41","TER","41"]]

Simplified JSON sample response [extended]

[["309542000","9252307","370190","34.327670","32.890000","119","91","92","0","2017-02-14T15:13:28","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","34530","2003","Oil Products Tanker","Tanker"],
["374886000","9647461","992387","36.754450","24.150640","192","157","158","0","2017-02-14T15:12:59","TER","0","MSC HAMBURG","70","3FYY8","PA","399","54","176490","186766","2015","Container Ship","Cargo"]]

Simplified JSON sample response [full]

[["309542000","9252307","370190","34.327500","32.898000","119","91","92","0","2017-02-14T15:15:27","TER","26","MAERSK REMLIN","80","C6VT2","BS","171.23","27.43","22184","-1","34530","2003","Oil Products Tanker","Tanker","","ODESSA","2017-02-06T12:53:00","LIMASSOL","2017-02-14T20:00:00","118","","","","124","UAODS","UA","270","CYLMS","LIMASSOL","CY","2017-02-14T17:25:00","2017-02-14T15:08:00","22"],
["374886000","9647461","992387","36.743010","24.156150","192","157","157","0","2017-02-14T15:15:18","TER","19","MSC HAMBURG","70","3FYY8","PA","399","54","176490","0","186766","2015","Container Ship","Cargo","","PIRAEUS","2017-02-14T10:47:00","SUEZ","2017-02-15T20:59:00","156","","","","1","GRPIR","GR","17181","EGSUZ","SUEZ CANAL","EG","2017-02-16T00:05:00","2017-02-14T15:14:00","617">]]

JSON object sample response [simple]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42"}]

JSON object sample response [extended]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN","SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG","SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo"}]

JSON object sample response [full]

[{"MMSI":309542000","IMO":9252307","SHIPID":370190","LAT":34.329670","LON":32.675670","SPEED":119","HEADING":89","COURSE":84","STATUS":0","TIMESTAMP":2017-02-14T14:19:48","DSRC":TER","UTC_SECONDS":49","SHIPNAME":MAERSK REMLIN" ,"SHIPTYPE":80","CALLSIGN":C6VT2","FLAG":BS","LENGTH":171.23","WIDTH":27.43","GRT":22184","DWT":34530","YEAR_BUILT":2003","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Tanker","CURRENT_PORT":","LAST_PORT":ODESSA","LAST_PORT_TIME":2017-02-06T12:53:00","DESTINATION":LIMASSOL","ETA":2017-02-14T20:00:00","DRAUGHT":118","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":124","LAST_PORT_UNLOCODE":UAODS","LAST_PORT_COUNTRY":UA","NEXT_PORT_ID":270","NEXT_PORT_UNLOCODE":CYLMS","NEXT_PORT_NAME":LIMASSOL","NEXT_PORT_COUNTRY":CY","ETA_CALC":2017-02-14T17:18:00","ETA_UPDATED":2017-02-14T14:06:00","DISTANCE_TO_GO":27"},
{"MMSI":374886000","IMO":9647461","SHIPID":992387","LAT":37.016960","LON":24.000240","SPEED":196","HEADING":155","COURSE":157","STATUS":0","TIMESTAMP":2017-02-14T14:18:41","DSRC":TER","UTC_SECONDS":42","SHIPNAME":MSC HAMBURG" ,"SHIPTYPE":70","CALLSIGN":3FYY8","FLAG":PA","LENGTH":399","WIDTH":54","GRT":176490","DWT":186766","YEAR_BUILT":2015","TYPE_NAME":Oil Products Tanker","AIS_TYPE_SUMMARY":Cargo","CURRENT_PORT":","LAST_PORT":PIRAEUS","LAST_PORT_TIME":2017-02-14T10:47:00","DESTINATION":SUEZ","ETA":2017-02-15T20:59:00","DRAUGHT":156","PORT_ID":","PORT_UNLOCODE":","PORT_COUNTRY":","LAST_PORT_ID":1","LAST_PORT_UNLOCODE":GRPIR","LAST_PORT_COUNTRY":GR","NEXT_PORT_ID":17181","NEXT_PORT_UNLOCODE":EGSUZ","NEXT_PORT_NAME":SUEZ CANAL","NEXT_PORT_COUNTRY":EG","ETA_CALC":2017-02-15T21:14:00","ETA_UPDATED":2017-02-14T14:12:00","DISTANCE_TO_GO":27"}]

Click here to read the response fields of previous version (v:7)

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT	integer	The year that the subject vessel was built
ROT	integer	Rate of Turn
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
CURRENT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
LAST_PORT_NAME	text	The Name of the Last Port the vessel has visited
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED	real	The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED	real	The maximum speed reported by the subject vessel during the latest voyage (port to port)

Version 7

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING	integer	The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	integer	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
DSRC	text	Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite AIS Station
UTC_SECONDS	integer	The time slot that the subject vessel uses to transmit information

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
TYPE_NAME	text	The Type of the subject vessel
AIS_TYPE_SUMMARY	text	Further explanation of the SHIPTYPE ID

Full response

( Including all Simple and Extended response fields )

Field Name	Data Type	Description
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination

Description: Vessel Particulars

Endpoint URL: https://services.marinetraffic.com/api/vesselmasterdata/v:4

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object).
mmsi	yes (only use one of the three)	integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track (single or comma separated values).
imo				The International Maritime Organization (IMO) number of the vessel you wish to track (single or comma separated values).
shipid				A uniquely assigned ID by MarineTraffic for the subject vessel.
timespan	no	integer		The timespan parameter defines the period of time, during which we want to receive the change in a vessel's details. The maximum value can be either 5 when the interval parameter is set to days or 2880 when the interval is set to minutes.
interval	no	text	minutes	The interval parameter can be either minutes or days.

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
If page parameter is missing, then default page:1 will be used instead
The results returned from the API call are split into pages of 100 rows
In order to get each page generated by the call, add the /page:#value/ parameter to the URL. The default value is /page:1/
The API does not return results for dead vessels

Typical API call:
https://services.marinetraffic.com/api/vesselmasterdata/v:4/YOUR-API-KEY/imo:value/protocol:value

Example API call:
https://services.marinetraffic.com/api/vesselmasterdata/v:4/8205c862d0572op1655989d939f1496c092ksvs4/imo:9375783/protocol:xml

Example API call using the timespan and interval parameters:
https://services.marinetraffic.com/api/vesselmasterdata/v:4/8205c862d0572op1655989d939f1496c092ksvs4/imo:9375783/protocol:xml/timespan:3/interval:days

XML sample response

<MASTERDATA TOTAL_RESULTS="1" TOTAL_PAGES="1" CURRENT_PAGE="1">
	<vessel MMSI="275507000" IMO="9375783" NAME="LIBERO" PLACE_OF_BUILD="" BUILD="2006" BREADTH_EXTREME="12.4" SUMMER_DWT="2930" DISPLACEMENT_SUMMER="" CALLSIGN="YLPS" FLAG="LV" DRAUGHT="4.36" LENGTH_OVERALL="88.53" FUEL_CONSUMPTION="" SPEED_MAX="" SPEED_SERVICE="10.5" LIQUID_OIL="" OWNER="BOJEN" MANAGER="BOJEN" FINANCIAL_OWNER="" TECHNICAL_MANAGER="" VESSEL_TYPE="GENERAL CARGO"/>
</MASTERDATA>

CSV sample response

TOTAL_RESULTS, TOTAL_PAGES, CURRENT_PAGE
1,1,1
MMSI, IMO, NAME, PLACE_OF_BUILD, BUILD, BREADTH_EXTREME, SUMMER_DWT, DISPLACEMENT_SUMMER, CALLSIGN, FLAG, DRAUGHT, LENGTH_OVERALL, FUEL_CONSUMPTION, SPEED_MAX, SPEED_SERVICE, LIQUID_OIL, OWNER, MANAGER, FINANCIAL_OWNER, TECHNICAL_MANAGER, VESSEL_TYPE
275507000,9375783,LIBERO,,2006,12.4,2930,,YLPS,LV,4.36,88.53,,,10.5,,BOJEN,BOJEN,,,GENERAL CARGO

Simplified JSON sample response

[["275507000","9375783","LIBERO","","2006","12.4","2930","","YLPS","LV","4.36","88.53","","","10.5","","BOJEN","BOJEN","","","GENERAL CARGO"]]

JSON object sample response [simple]

{"METADATA":{"TOTAL_RESULTS":1,"TOTAL_PAGES":1,"CURRENT_PAGE":1},"DATA":
[{"MMSI":"275507000","IMO":"9375783","NAME":"LIBERO","PLACE_OF_BUILD":"","BUILD":"2006","BREADTH_EXTREME":"12.4","SUMMER_DWT":"2930","DISPLACEMENT_SUMMER":"","CALLSIGN":"YLPS","FLAG":"LV","DRAUGHT":"4.36","LENGTH_OVERALL":"88.53","FUEL_CONSUMPTION":"","SPEED_MAX":"","SPEED_SERVICE":"10.5","LIQUID_OIL":"","OWNER":"BOJEN","MANAGER":"BOJEN","FINANCIAL_OWNER":"","TECHNICAL_MANAGER":"","VESSEL_TYPE":"GENERAL CARGO"}]}

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
NAME	text	The Name of the subject vessel
PLACE_OF_BUILD	text	The place the subject vessel was built at
BUILD	integer	The year that the subject vessel was built
BREADTH_EXTREME	real	The extreme breadth (in metres) of the subject vessel
SUMMER_DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
DISPLACEMENT_SUMMER	integer	Displacement - a measure of the vessel's weight
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
DRAUGHT	real	The Maximum Draught (in metres) of the subject vessel
LENGTH_OVERALL	real	The Overall Length (in metres) of the subject vessel
FUEL_CONSUMPTION	text	The Fuel Consumption of the subject vessel
SPEED_MAX	real	The Maximum Operational Speed of the subject vessel
SPEED_SERVICE	real	The Speed that the vessel is designed to sail under certain conditions
LIQUID_OIL	integer	The Capacity (in cubic metres) of the wet cargo the vessel can carry
OWNER	text	The Owning Company of the subject vessel
MANAGER	text	The Managing Company of the subject vessel
FINANCIAL_OWNER	text	The Financial Owner of the subject vessel
TECHNICAL_MANAGER	text	The Technical Manager of the subject vessel
VESSEL_TYPE	text	The specific type of the subject vessel

Description: Search for a vessel

Endpoint URL: https://services.marinetraffic.com/api/shipsearch

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
mmsi	yes (only use one of the four)	integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track. NOTE: Using MMSI may potentially return multiple records as multiple vessels might have transponded the same MMSI
imo				The International Maritime Organization (IMO) number of the vessel you wish to track. NOTE: Using IMO may potentially return multiple records as multiple vessels might have transponded the same IMO
shipid				A uniquely assigned ID by MarineTraffic for the subject vessel.
shipname		text		The vessel name. The results will contain all vessels whose name is like the given words. NOTE: Using vessel name may potentially return multiple records as multiple vessels might have transponded the same vessel name
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)
type_name_id	no	integer		Data filter: Vessel type. Find more information here

Note

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data

Typical API call:
https://services.marinetraffic.com/api/shipsearch/YOUR-API-KEY/imo:value/protocol:value

Example API call:
https://services.marinetraffic.com/api/shipsearch/8205c862d0572op1655989d939f1496c092ksvs4/imo:9375783/protocol:xml

XML sample response

<VESSELS>
<vessel SHIPNAME="FOUR SMILE" MMSI="247271800" IMO="9189146" SHIP_ID="280171" CALLSIGN="IBPQ" TYPE_NAME="Oil Products Tanker" DWT="160573" FLAG="IT" COUNTRY="Italy" YEAR_BUILT="2001" MT_URL="https://www.marinetraffic.com/en/ais/details/ships/shipid:280171/mmsi:247271800/vessel:280171"
</VESSELS>

CSV sample response

SHIPNAME, MMSI, IMO, SHIP_ID, CALLSIGN, TYPE_NAME, DWT, FLAG, COUNTRY, YEAR_BUILT, MT_URL
FOUR SMILE,247271800,9189146,280171,IBPQ,Oil Products Tanker,160573,IT,Italy,2001,https://www.marinetraffic.com/en/ais/details/ships/shipid:280171/mmsi:247271800/vessel:280171

Simplified JSON sample response

[["FOUR SMILE","247271800","9189146","280171","IBPQ","Oil Products Tanker","160573","IT","Italy","2001","https:\/\/www.marinetraffic.com\/en\/ais\/details\/ships\/shipid:280171\/mmsi:247271800\/vessel:280171"]]

JSON object sample response [simple]

[{"SHIPNAME":"FOUR SMILE","MMSI":"247271800","IMO":"9189146","SHIP_ID":"280171","CALLSIGN":"IBPQ","TYPE_NAME":"Oil Products Tanker","DWT":"160573","FLAG":"IT","COUNTRY":"Italy","YEAR_BUILT":"2001","MT_URL":"https:\/\/www.marinetraffic.com\/en\/ais\/details\/ships\/shipid:280171\/mmsi:247271800\/vessel:280171"}]

Simple response

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
TYPE_NAME	text	The Type of the subject vessel
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
COUNTRY	text	The country of the subject vessel according to AIS transmissions.
YEAR_BUILT	integer	The year that the subject vessel was built
MT_URL	text	URL to the Details page of the subject vessel at MarineTraffic

Description: Expected Arrivals

To look for expected arrivals in a specific date range, use the timespan or the fromdate/todate parameters.

Endpoint URL: https://services.marinetraffic.com/api/expectedarrivals/v:3

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer		Number of days in the future to look for expected arrivals, starting from the time the API call is requested. Maximum value is 40 days. If neither this nor the fromdate/todate parameters are used, the response only includes vessels currently in port (or the country’s ports) and the last vessel's signal is received during the last 2 days.
days_last_signal	no	int	2	Include vessels currently in port that have transmitted a position within the last x days (based on their last signal timestamp). This parameter only works when no other timeframe is defined.
fromdate	no (use together)	datetime		Timestamp in the future to start looking for expected arrivals. Date format: YYYY-MM-DD HH:MM:SS
todate	no (use together)	datetime
msgtype	no	text	simple	If used with the value extended, apart from the ETA information, the response includes main vessel particulars. If omitted, the returned records include only position and ETA reports.
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
portid	yes (only use one of the two)	integer/text		The MarineTraffic ID of the port (found on the URL of the respective Port page) or port UNLOCODE.
country	yes (only use one of the two)	text		The Country code of interest. Response includes all ports within the Country.
fromportid	no (only use one of the two)	integer/text		The MarineTraffic ID of the previous port (found on the URL of the respective Port page) or previous port UNLOCODE.
fromcountry	no (only use one of the two)	text		The Country code of interest. Response includes only vessels departed from a selected Country.
shiptype	no	integer		Data filter: Vessel type. (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)
dwt_min	no (use together)	integer		Data filter: minimum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype = 7, 8)
dwt_max	no (use together)	integer		Data filter: maximum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype = 7, 8)
gt_min	no (use together)	integer		Data filter: minimum GT applicable to IMO-having vessels
gt_max	no (use together)	integer		Data filter: maximum GT applicable to IMO-having vessels

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC
Use either TIMESPAN or FROMDATE/TODATE in order to look for expected arrivals in a specific date range

Typical API call:
https://services.marinetraffic.com/api/expectedarrivals/v:3/YOUR-API-KEY/timespan:#days/country:value/dwt_min:value/dwt_max:value/shiptype:value/protocol:value

Example API call:
https://services.marinetraffic.com/api/expectedarrivals/v:3/8205c862d0572op1655989d939f1496c092ksvs4/timespan:2/country:US/dwt_min:100000/dwt_max:160000/shiptype:7/protocol:xml

XML sample response [simple]

<ETA>
<VESSEL_ETA MMSI="249713000" LAT="37.669050" LON="23.770750" SPEED="135" COURSE="325" STATUS="0"  PORT_ID=270""  PORT_UNLOCODE="" CURRENT_PORT="" CURRENT_PORT_COUNTRY="" NEXT_PORT_ID="1" NEXT_PORT_UNLOCODE="GRPIR" NEXT_PORT_NAME="PIRAEUS" NEXT_PORT_COUNTRY="GR" ETA="2014-02-21T10:11:00" ETA_CALC="2014-02-20T10:11:00" ETA_UPDATED="2014-02-20 04:05:00" TIMESTAMP="2014-02-20T09:22:05" />
<VESSEL_ETA MMSI="353850000" LAT="37.631180" LON="23.904200" SPEED="133" COURSE="146" STATUS="0"  PORT_ID=1"" PORT_UNLOCODE="" CURRENT_PORT="" CURRENT_PORT_COUNTRY="" NEXT_PORT_ID="1" NEXT_PORT_UNLOCODE="GRPIR" NEXT_PORT_NAME="PIRAEUS" NEXT_PORT_COUNTRY="GR" ETA="2014-02-22T20:22:00" ETA_UPDATED="2014-02-20 06:03:00" TIMESTAMP="2014-02-20T09:20:05" />
<VESSEL_ETA MMSI="538004631" LAT="37.463669" LON="25.32655" SPEED="125" COURSE="146" STATUS="0"  PORT_ID="" PORT_UNLOCODE="" CURRENT_PORT="" CURRENT_PORT_COUNTRY="" NEXT_PORT_ID="1" NEXT_PORT_UNLOCODE="GRPIR" NEXT_PORT_NAME="PIRAEUS" NEXT_PORT_COUNTRY="GR" ETA="2014-02-21T18:46:00" ETA_UPDATED="2014-02-20 03:04:00" TIMESTAMP="2014-02-20T08:49:15" />
</ETA>

XML sample response [extended]

<ETA>
<VESSEL_ETA IMO="9255684" MMSI="240176000" SHIPNAME="MINERVA ZOE" TYPE_NAME="Crude Oil Tanker" SHIPTYPE="71" CALLSIGN="SYBC" FLAG="GR" LENGTH="244" WIDTH="42.03" DRAUGHT="86" GRT="57301" DWT="105330" YEAR_BUILT="2004" LAT="41.361460" LON="17.722050" SPEED="95" COURSE="125" STATUS="0" ETA="2014-12-22T10:11:00" ETA_CALC="2014-02-22T19:22:00" ETA_UPDATED="2014-02-19T19:22:00"  LAST_PORT_ID="20443" LAST_PORT="TRIESTE ANCH" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="IT" LAST_PORT_TIME="2014-02-17T23:29:00" PORT_ID="" PORT_UNLOCODE="" CURRENT_PORT="" CURRENT_PORT_COUNTRY="" NEXT_PORT_ID="1" NEXT_PORT_UNLOCODE="GRPIR" NEXT_PORT_NAME="PIRAEUS" NEXT_PORT_COUNTRY="GR" TIMESTAMP="2014-02-19T10:22:51" />
<VESSEL_ETA IMO="9233624" MMSI="371043000" SHIPNAME="BARU SATU" TYPE_NAME="Bulk Carrier" SHIPTYPE="73" CALLSIGN="H9AN" FLAG="PA" LENGTH="137.03" WIDTH="23" DRAUGHT="43" GRT="9978" DWT="16190" YEAR_BUILT="2001" LAT="37.669050" LON="23.770750" SPEED="122" COURSE="25" STATUS="0" ETA="2014-12-25T14:24:00" ETA_UPDATED="2014-02-20 10:53:00" LAST_PORT_ID="20582" LAST_PORT= "VALENCIA ANCH" LAST_PORT_UNLOCODE="" LAST_PORT_COUNTRY="ES" LAST_PORT_TIME="2014-02-17T23:29:00" PORT_ID="" PORT_UNLOCODE="" CURRENT_PORT="" CURRENT_PORT_COUNTRY="" NEXT_PORT_ID="1" NEXT_PORT_UNLOCODE="GRPIR"  NEXT_PORT_NAME="PIRAEUS" NEXT_PORT_COUNTRY="GR" TIMESTAMP="2014-02-20T10:22:51"/>
<VESSEL_ETA IMO="9153551" MMSI="636010789" SHIPNAME="EURO SPIRIT" TYPE_NAME="Vehicles Carrier" SHIPTYPE="75" CALLSIGN="ELUW8" FLAG="LR" LENGTH="188" WIDTH="31.2" DRAUGHT="77" GRT="46346" DWT="15483" YEAR_BUILT="1998" LAT="42.050480" LON="10.390520" SPEED="152" COURSE="132" STATUS="0" ETA="2014-12-22T11:48:00" ETA_UPDATED="2014-02-20 05:54:00" LAST_PORT_ID="88" LAST_PORT="LIVORNO" LAST_PORT_UNLOCODE="ITLIV" LAST_PORT_COUNTRY="IT" LAST_PORT_TIME="2014-02-20T00:46:00" PORT_ID="" PORT_UNLOCODE="" CURRENT_PORT="" CURRENT_PORT_COUNTRY="" NEXT_PORT_ID="1" NEXT_PORT_UNLOCODE="GRPIR" NEXT_PORT_NAME="PIRAEUS" NEXT_PORT_COUNTRY="GR" TIMESTAMP="2014-02-20T07:14:48" />
</ETA>

CSV sample response [simple]

MMSI, LAT, LON, SPEED, COURSE, STATUS, PORT_ID, PORT_UNLOCODE, CURRENT_PORT, CURRENT_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA, ETA_CALC, ETA_UPDATED, TIMESTAMP
256707000,34.846330,32.027830,101,294,0,,,,,1,GRPIR,PIRAEUS,GR,2014-02-21T19:05:00,2014-02-19 23:53:00,2014-02-20T03:39:48 219116000,36.468350,15.176570,142,91,0,,,,1,GRPIR,PIRAEUS,GR,2014-02-22T20:25:00,2014-02-21T20:22:00,2014-02-20 06:03:00,2014-02-20T09:35:06 215896000,39.892000,14.578330,169,153,0,,,,GRPIR,PIRAEUS,GR,2014-02-22T06:55:00,2014-02-20 09:35:00,2014-02-20T11:39:43

CSV sample response [extended]

IMO, MMSI, SHIPNAME, TYPE_NAME, SHIPTYPE,CALLSIGN, FLAG, LENGTH, WIDTH, DRAUGHT, GRT, DWT, YEAR_BUILT, LAT, LON, SPEED, COURSE, STATUS, ETA, ETA_CALC, ETA_UPDATED, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, LAST_PORT_TIME, PORT_ID,PORT_UNLOCODE, CURRENT_PORT, CURRENT_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, TIMESTAMP
9113446,215896000,BAVARIA,Container Ship,71,9HA2804,MT,159.08,24,88,14473,18335,1996,39.892000,14.578330,169,153,0,2014-02-22T06:55:00,2014-02-20 09:35:00,20443,NAPOLI ANCH,,IT,2014-02-25T07:43:00,2014-02-20T07:49:00,,,,1,GRPIR,PIRAEUS,GR,2014-02-20T11:39:43
9153551,636010789,EURO SPIRIT,Vehicles Carrier,74,ELUW8,LR,188,31.2,77,46346,15483,1998,42.050480,10.390520,171,132,0,2014-02-22T11:48:00,2014-02-20 05:54:00,20582,LIVORNO,ITLIV,IT,2014-03-20T07:49:00,2014-02-25T01:46:00,,,,1,GRPIR,PIRAEUS,GR,2014-02-20T07:14:48
9255684,240176000,MINERVA ZOE,Crude Oil Tanker,78,SYBC,GR,244,42.03,86,57301,105330,2004,41.361460,17.722050,95,125,0,2014-02-22T19:22:00,2014-02-20 05:53:00,88,TRIESTE ANCH,,IT,,2014-04-23T07:49:00,2014-02-19T20:21:00,,,,1,GRPIR,PIRAEUS,GR,2014-02-20T09:55:54

Simplified JSON sample response [simple]

[["240391000","38.004240","23.522880","102","281","3","","","","","1","GRPIR","PIRAEUS","GR","2014-02-21T13:18:00","2014-02-20T12:18:00","2014-02-20 11:55:00","2014-02-20T11:48:45"],["538004631","37.592600","23.897660","120","279","0","","","","1","GRPIR","PIRAEUS","GR","2014-02-22T13:44:00","2014-02-20T13:44:00","2014-02-20 09:33:00","2014-02-20T11:57:22"],["229637000","37.478790","23.734610","137","8","0","","","","1","GRPIR","PIRAEUS","GR","2014-02-23T14:13:00","2014-02-20T14:13:00","2014-02-20 10:22:00","2014-02-20T11:58:02"]]

Simplified JSON sample response [extended]

[["9113446","215896000","BAVARIA","Container Ship","70","9HA2804","MT","159.08","24","88","14473","18335","1996","39.892000","14.578330","169","153","0","2014-02-24T06:55:00","2014-02-22T06:55:00","2014-02-20 09:35:00","20443","NAPOLI ANCH","","IT","2014-02-20T07:49:00","","","","1","GRPIR","PIRAEUS","GR","2014-02-20T11:39:43"],["9153551","636010789","EURO SPIRIT","Vehicles Carrier","74","ELUW8","LR","188","31.2","77","46346","15483","1998","42.050480","10.390520","171","132","0","2014-02-23T11:48:00""2014-02-22T11:48:00","2014-02-20 05:54:00","20582","LIVORNO","ITLIV","IT","2014-02-20T00:46:00","","","","1","GRPIR","PIRAEUS","GR","2014-02-20T07:14:48"],["9255684","240176000","MINERVA ZOE","Crude Oil Tanker","81","SYBC","GR","244","42.03","86","57301","105330","2004","41.361460","17.722050","95","125","0","2014-02-23T19:22:00","2014-02-22T19:22:00","2014-02-20 05:53:00","88","TRIESTE ANCH","","IT","2014-02-18T20:22:00","","","","1","GRPIR","PIRAEUS","GR","2014-02-20T09:55:54"]]

JSON object sample response [simple]

[{"MMSI":"239672000","LAT":"35.490500","LON":"24.076030","SPEED":"0","COURSE":"158","STATUS":"0","PORT_ID":"9","PORT_UNLOCODE":"GRSDH","CURRENT_PORT":"SOUDA","CURRENT_PORT_COUNTRY":"GR","NEXT_PORT_ID":"1","NEXT_PORT_UNLOCODE":"GRPIR","NEXT_PORT_NAME":"PIRAEUS","NEXT_PORT_COUNTRY":"GR","ETA":"2016-10-20T22:36:00","ETA_CALC":"2016-10-19T22:36:00","ETA_UPDATED":"2016-10-19 14:35:00","TIMESTAMP":"2016-10-19T14:31:22"},
{"MMSI":"249046000","LAT":"36.445610","LON":"28.231850","SPEED":"0","COURSE":"179","STATUS":"5","PORT_ID":"59","CURRENT_PORT":"RHODES","CURRENT_PORT_COUNTRY":"GR","NEXT_PORT_ID":"1","NEXT_PORT_UNLOCODE":"GRPIR","NEXT_PORT_NAME":"PIRAEUS","NEXT_PORT_COUNTRY":"GR","ETA":"2016-10-21T22:36:00","ETA_CALC":"2016-10-19T23:42:00","ETA_UPDATED":"2016-10-19 14:13:00","TIMESTAMP":"2016-10-19T14:30:31"},
{"MMSI":"237641000","LAT":"35.344450","LON":"25.144000","SPEED":"0","COURSE":"343","STATUS":"5","PORT_ID":"11","CURRENT_PORT":"HERACLIO","CURRENT_PORT_COUNTRY":"GR","NEXT_PORT_ID":"1","NEXT_PORT_UNLOCODE":"GRPIR","NEXT_PORT_NAME":"PIRAEUS","NEXT_PORT_COUNTRY":"GR","ETA":"2016-10-22T22:36:00","ETA_CALC":"2016-10-19T23:47:00","ETA_UPDATED":"2016-10-19 14:36:00","TIMESTAMP":"2016-10-19T14:31:31"}]

JSON object sample response [extended]

[{"IMO":"7350325","MMSI":"239308000","SHIPNAME":"IONIS","TYPE_NAME":"Ro-Ro\/Passenger Ship","SHIPTYPE":"71","CALLSIGN":"SVKU","FLAG":"GR","LENGTH":"96","WIDTH":"17","DRAUGHT":"44","GRT":"2604","DWT":"880","YEAR_BUILT":"1977","LAT":"37.914780","LON":"23.604830","SPEED":"164","COURSE":"63","STATUS":"0","ETA":"2016-10-20T10:36:00","ETA_CALC":"","ETA_UPDATED":"","LAST_PORT_ID":"6","LAST_PORT":"AEGINA","LAST_PORT_UNLOCODE":"GRAEG","LAST_PORT_COUNTRY":"GR","LAST_PORT_TIME":"2016-10-19T13:06:00","PORT_ID":"","PORT_UNLOCODE":"","CURRENT_PORT":"","CURRENT_PORT_COUNTRY":"","NEXT_PORT_ID":"1","NEXT_PORT_UNLOCODE":"GRPIR","NEXT_PORT_NAME":"PIRAEUS","NEXT_PORT_COUNTRY":"GR","TIMESTAMP":"2016-10-19T14:03:08"},
{"IMO":"9204477","MMSI":"636016118","SHIPNAME":"VENTO DI GRECALE","TYPE_NAME":"Container Ship","SHIPTYPE":"74","CALLSIGN":"D5EO2","FLAG":"LR","LENGTH":"184","WIDTH":"25","DRAUGHT":"71","GRT":"16802","DWT":"22990","YEAR_BUILT":"1999","LAT":"35.961950","LON":"17.550300","SPEED":"3","COURSE":"85","STATUS":"0","ETA":"2016-10-21T10:36:00","ETA_CALC":"2016-10-19T10:36:00","ETA_UPDATED":"2016-10-17 23:01:00","LAST_PORT_ID":"225","LAST_PORT":"LA SPEZIA","LAST_PORT_UNLOCODE":"ITSPE","LAST_PORT_COUNTRY":"IT","LAST_PORT_TIME":"2016-09-13T18:27:00","PORT_ID":"","PORT_UNLOCODE":"","CURRENT_PORT":"","CURRENT_PORT_COUNTRY":"","NEXT_PORT_ID":"1","NEXT_PORT_UNLOCODE":"GRPIR","NEXT_PORT_NAME":"PIRAEUS","NEXT_PORT_COUNTRY":"GR","TIMESTAMP":"2016-10-18T09:09:00"},
{"IMO":"8859184","MMSI":"237247600","SHIPNAME":"FLYING DOLPHIN ATHINA","TYPE_NAME":"Hydrofoil","SHIPTYPE":"79","CALLSIGN":"SW7686","FLAG":"GR","LENGTH":"34.5","WIDTH":"5.8","DRAUGHT":"18","GRT":"161","DWT":"0","YEAR_BUILT":"1991","LAT":"37.787280","LON":"23.449720","SPEED":"326","COURSE":"53","STATUS":"0","ETA":"2016-10-20T10:36:00","ETA_CALC":"2016-10-19T14:57:00","ETA_UPDATED":"2016-10-19 14:25:00","LAST_PORT_ID":"6","LAST_PORT":"AEGINA","LAST_PORT_UNLOCODE":"GRAEG","LAST_PORT_COUNTRY":"GR","LAST_PORT_TIME":"2016-10-19T14:16:00","PORT_ID":"","PORT_UNLOCODE":"","CURRENT_PORT":"","CURRENT_PORT_COUNTRY":"","NEXT_PORT_ID":"1","NEXT_PORT_UNLOCODE":"GRPIR","NEXT_PORT_NAME":"PIRAEUS","NEXT_PORT_COUNTRY":"GR","TIMESTAMP":"2016-10-19T14:22:16"}]

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
LAT	real	Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's surface
LON	real	Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's surface
SPEED	integer	The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
COURSE	integer	The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS	text	The AIS Navigational Status of the subject vessel as input by the vessel's crew - more. There might be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots.
PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT	text	The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
CURRENT_PORT_COUNTRY	text	The Country that the Current Port is located at
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY	text	The Country that the Next Port is located at
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_UPDATED	date	The date and time (in UTC) that the ETA was calculated by MarineTraffic
TIMESTAMP	date	The date and time (in UTC) that the subject vessel's position was recorded by MarineTraffic
PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Current Port

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIPNAME	text	The Shipname of the subject vessel
TYPE_NAME	text	The Type of the subject vessel
SHIPTYPE	integer	The Shiptype of the subject vessel according to AIS transmissions - more
CALLSIGN	text	A uniquely designated identifier for the vessel's transmitter station
FLAG	text	The flag of the subject vessel according to AIS transmissions - more
LENGTH	real	The overall Length (in metres) of the subject vessel
WIDTH	real	The Breadth (in metres) of the subject vessel
DRAUGHT	real	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
GRT	integer	Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT	integer	Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the vessel's own weight)
YEAR_BUILT	integer	The year that the subject vessel was built
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY	text	The Country that the Last Port is located at
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port

Description: Port Distances and Routes

Endpoint URL: https://services.marinetraffic.com/api/exportroutes

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
port_start_id	yes (use either port_start_id or LAT,LON or mmsi or imo or shipid	integer		The MarineTraffic ID of the port you wish to put as starting point (found on the URL of the respective Port page) or port UN/LOCODE.
LAT		float		The latitude of the starting point
LON		float		The longitude of the starting point
mmsi		integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track.
imo				The International Maritime Organization (IMO) number of the vessel you wish to track.
shipid				A uniquely assigned ID by MarineTraffic for the subject vessel.
port_target_id	yes	integer		The MarineTraffic ID of the port you wish to put as target port (found on the URL of the respective Port page) or port UN/LOCODE.
includealternatives	no	integer	0	Use 1 to search for all available routes regarding the specific journey or 0 to not include alternative routes
includeinland	no	integer	0	Use 1 in order to receive routes which include inland waterways or 0 to not include alternative routes
msgtype	no	text	simple	If used with the value extended, the response includes also route/waypoints as Linestring Geometry in WKT - Well-Known Text
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data

Typical API calls:

https://services.marinetraffic.com/api/exportroutes/YOUR-API-KEY/port_start_id:value/port_target_id:value/includealternatives:value/includeinland:value/msgtype:value/protocol:value
https://services.marinetraffic.com/api/exportroutes/YOUR-API-KEY/LAT:value/LON:value/port_target_id:value/includealternatives:value/includeinland:value/msgtype:value/protocol:value
https://services.marinetraffic.com/api/exportroutes/YOUR-API-KEY/mmsi:value/port_target_id:value/includealternatives:value/includeinland:value/msgtype:value/protocol:value

Example API call:
https://services.marinetraffic.com/en/api/exportroutes/1ff13f11af079qo134g134gg13r4gv146133ec0a/port_start_id:1/port_target_id:1253/includealternatives:1/includeinland:1/msgtype:simple/

XML sample response [simple]

<ROUTES>
<route DISTANCE="8842" PANAMA="0" SUEZ="1" />
<route DISTANCE="7891" PANAMA="0" SUEZ="1" />
<route DISTANCE="8494" PANAMA="0" SUEZ="1" />
</ROUTES>

XML sample response [extended]

<ROUTES>
<route DISTANCE="8842" PANAMA="0" SUEZ="1" FINAL_PATH="LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.007 31.0831, 121.92 31.131, 121.85 31.1757)" />
<route DISTANCE="7891" PANAMA="0" SUEZ="1" FINAL_PATH="LINESTRING (23.5935 37.9475, 23.5997 37.9455, 23.605 37.9413, ***OMITTED***, 122.867 31.0829, 122.308 31.1024, 122.093 31.228)" />
<route DISTANCE="8494" PANAMA="0" SUEZ="1" FINAL_PATH="LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.093 31.2235, 121.749 31.3015, 121.601 31.3814)" />
</ROUTES>

CSV sample response [simple]

DISTANCE, PANAMA, SUEZ
8842,0,1
7891,0,1
8494,0,1

CSV sample response [extended]

DISTANCE, PANAMA, SUEZ
8842,0,1,LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.007 31.0831, 121.92 31.131, 121.85 31.1757)
7891,0,1,LINESTRING (23.5935 37.9475, 23.5997 37.9455, 23.605 37.9413, ***OMITTED***, 122.867 31.0829, 122.308 31.1024, 122.093 31.228)
8494,0,1,LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.093 31.2235, 121.749 31.3015, 121.601 31.3814)

Simplified JSON sample response [simple]

[["7891","0","1"],["8494","0","1"],["8842","0","1"]]

Simplified JSON sample response [extended]

[["7891","0","1","LINESTRING (23.5993 37.9438, 23.6085 37.9353, 23.608 37.9262, ***OMITTED***, 122.423 31.0844, 122.308 31.1024, 122.093 31.228)"],["8494","0","1","LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.093 31.2235, 121.749 31.3015, 121.601 31.3814)"],["8842","0","1","LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.007 31.0831, 121.92 31.131, 121.85 31.1757)"]]

JSON object sample response [simple]

[{"DISTANCE":"7891","PANAMA":"0","SUEZ":"1"},
{"DISTANCE":"8494","PANAMA":"0","SUEZ":"1"},
{"DISTANCE":"8842","PANAMA":"0","SUEZ":"1"}]

JSON object sample response [extended]

[{"DISTANCE":"7891","PANAMA":"0","SUEZ":"1","FINAL_PATH":"LINESTRING (23.5935 37.9475, 23.5997 37.9455, 23.605 37.9413, ***OMITTED***, 122.867 31.0829, 122.308 31.1024, 122.093 31.228)"},
{"DISTANCE":"8494","PANAMA":"0","SUEZ":"1","FINAL_PATH":"LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.093 31.2235, 121.749 31.3015, 121.601 31.3814)"},
{"DISTANCE":"8842","PANAMA":"0","SUEZ":"1","FINAL_PATH":"LINESTRING (23.5986 37.9442, 23.6031 37.8379, 24.148 36.7719, ***OMITTED***, 122.007 31.0831, 121.92 31.131, 121.85 31.1757)"}]

Simple response

Field Name	Data Type	Description
DISTANCE	integer	The Distance (in NM) between the specified point or port to the destination port
PANAMA	integer	Whether the vessel route passes via the Panama canal
SUEZ	integer	Whether the vessel route passes via the Suez canal

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
FINAL_PATH	text	Route/Waypoints as Linestring Geometry in WKT - Well-Known Text

Description: Predictive Destinations

Endpoint URL: https://services.marinetraffic.com/api/predictive-destination-areas/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
shipid	yes (only use one of three)	integer		The MarineTraffic ID of the vessel you wish to monitor found on the URL of the respective Vessel page.
imo		integer		The International Maritime Organization (IMO) number of the vessel you wish to track.
fleet_id		integer		The MarineTraffic ID of the fleet you wish to track.
fromportid	no	integer		The MarineTraffic ID of the port you wish to receive a prediction (found on the URL of the respective Port page).

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data

Typical API call:
https://services.marinetraffic.com/api/predictive-destination-areas/YOUR-API-KEY/portid:value/timespan:#minutes

Example API call:
https://services.marinetraffic.com/api/predictive-destination-areas/bb6e6261b44aa8bcd8246928b11a8f02e8a2e805/imo:8105088/fromportid:1

XML sample response [simple]

<PredictiveDestinationAreas>
<PredictiveDestinationArea IMO="8105088" SHIP_ID="214973" MMSI="241324000" SHIPNAME="ERATO" SHIPCLASS="HANDYSIZE" MANAGER="SEKA 02 MARITIME" OWNER="SEKA 02 MARITIME" FROM_PORT_ID="1" FROM_PORT="PIRAEUS" NEXT_PORT_1_ID="812"  NEXT_PORT_1="KALI LIMENES" NEXT_PORT_1_PROB="0.563" NEXT_AREA_1="EMED" NEXT_AREA_1_PROB="0.875" NEXT_PORT_2_ID="29" NEXT_PORT_2="AGIOI THEODOROI" NEXT_PORT_2_PROB="0.250" NEXT_AREA_2="EMED" NEXT_AREA_2_PROB="0.875" NEXT_PORT_3_ID="17" NEXT_PORT_3="CORINTH CANAL" NEXT_PORT_3_PROB="0.063" NEXT_AREA_3="EMED" NEXT_AREA_3_PROB="0.875" NEXT_PORT_4_ID="2507" NEXT_PORT_4="TRIPOLI" NEXT_PORT_4_PROB="0.063" NEXT_AREA_4="WMED" NEXT_AREA_4="WMED" NEXT_AREA_4="WMED" NEXT_AREA_4_PROB="0.063" NEXT_PORT_5_ID="1688" NEXT_PORT_5="TUZLA" NEXT_PORT_5_PROB="0.063" NEXT_AREA_5="BSEA" NEXT_AREA_5_PROB="0.063" />
</PredictiveDestinationAreas>

CSV sample response [simple]

IMO, SHIP_ID, MMSI, SHIPNAME, SHIPCLASS, MANAGER, OWNER, FROM_PORT_ID, FROM_PORT, NEXT_PORT_1_ID, NEXT_PORT_1, NEXT_PORT_1_PROB, NEXT_AREA_1, NEXT_AREA_1_PROB, NEXT_PORT_2_ID, NEXT_PORT_2, NEXT_PORT_2_PROB, NEXT_AREA_2, NEXT_AREA_2_PROB, NEXT_PORT_3_ID, NEXT_PORT_3, NEXT_PORT_3_PROB, NEXT_AREA_3, NEXT_AREA_3_PROB, NEXT_PORT_4_ID, NEXT_PORT_4, NEXT_PORT_4_PROB, NEXT_AREA_4, NEXT_AREA_4_PROB, NEXT_PORT_5_ID, NEXT_PORT_5, NEXT_PORT_5_PROB, NEXT_AREA_5, NEXT_AREA_5_PROB
214973,8105088,214973,241324000,ERATO,HANDYSIZE,SEKA 02 MARITIME,SEKA 02 MARITIME,1,PIRAEUS,812,KALI LIMENES,0.563,EMED,0.875,29,AGIOI THEODOROI,0.250,EMED,0.875,17,CORINTH CANAL,0.063,EMED,0.875,1688,TUZLA,0.063,BSEA,0.063,2507,TRIPOLI,0.063,WMED,0.063

Simplified JSON sample response [simple]

["214973","8105088","214973","241324000","ERATO","HANDYSIZE","SEKA 02 MARITIME","SEKA 02 MARITIME","1","PIRAEUS","812","KALI LIMENES","0.563","EMED","0.875","29","AGIOI THEODOROI","0.250","EMED","0.875","17","CORINTH CANAL","0.063","EMED","0.875","1688","TUZLA","0.063","BSEA","0.063","2507","TRIPOLI","0.063","WMED","0.063"]

JSON object sample response [simple]

[{"IMO":"8105088","SHIP_ID":"214973","MMSI":"241324000","SHIPNAME":"ERATO","SHIPCLASS":"HANDYSIZE","MANAGER":"SEKA 02 MARITIME","OWNER":"SEKA 02 MARITIME","FROM_PORT_ID":"1","FROM_PORT":"PIRAEUS","NEXT_PORT_1_ID":"812","NEXT_PORT_1":"KALI LIMENES","NEXT_PORT_1_PROB":"0.563","NEXT_AREA_1":"EMED","NEXT_AREA_1_PROB":"0.875","NEXT_PORT_2_ID":"29","NEXT_PORT_2":"AGIOI THEODOROI","NEXT_PORT_2_PROB":"0.250","NEXT_AREA_2":"EMED","NEXT_AREA_2_PROB":"0.875","NEXT_PORT_3_ID":"17","NEXT_PORT_3":"CORINTH CANAL","NEXT_PORT_3_PROB":"0.063","NEXT_AREA_3":"EMED","NEXT_AREA_3_PROB":"0.875","NEXT_PORT_4_ID":"2507","NEXT_PORT_4":"TRIPOLI","NEXT_PORT_4_PROB":"0.063","NEXT_AREA_4":"WMED","NEXT_AREA_4":"WMED","NEXT_AREA_4":"WMED","NEXT_AREA_4_PROB":"0.063","NEXT_PORT_5_ID":"1688","NEXT_PORT_5":"TUZLA","NEXT_PORT_5_PROB":"0.063","NEXT_AREA_5":"BSEA","NEXT_AREA_5_PROB":"0.063"}]

Simple response

Field Name	Data Type	Description
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
SHIPNAME	text	The Shipname of the subject vessel
SHIPCLASS	text	The class of the subject vessel based on vessel type and size
MARKET	text	The commercial market segment the subject vessel belongs to
MANAGER	text	The Managing Company of the subject vessel
OWNER	text	The Owning Company of the subject vessel
FROM_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the port that was used as origin to retrieve possible destinations
FROM_PORT	text	The port that was used as origin to retrieve possible destinations
NEXT_PORT_1_ID	integer	A uniquely assigned ID by MarineTraffic for the most probable destination port from the given port of origin
NEXT_PORT_1	text	Most probable destination port from the given port of origin
NEXT_PORT_1_PROB	real	The probability of visiting the most likely destination port
NEXT_AREA_1	text	The area where the most probable port is
NEXT_AREA_1_PROB	real	The probability of visiting the area where the predicted port is
NEXT_PORT_2_ID	integer	A uniquely assigned ID by MarineTraffic for the second most probable destination port from the given port of origin
NEXT_PORT_2	text	Second most probable destination port from the given port of origin
NEXT_PORT_2_PROB	real	The probability of visiting the second most likely destination port
NEXT_AREA_2	text	The area where the second most probable port is
NEXT_AREA_2_PROB	real	The probability of visiting the area where the predicted port is
NEXT_PORT_3_ID	integer	A uniquely assigned ID by MarineTraffic for the third most probable destination port from the given port of origin
NEXT_PORT_3	text	Third most probable destination port from the given port of origin
NEXT_PORT_3_PROB	real	The probability of visiting the third most likely destination port
NEXT_AREA_3	text	The area where the third most probable port is
NEXT_AREA_3_PROB	real	The probability of visiting the area where the predicted port is
NEXT_PORT_4_ID	integer	A uniquely assigned ID by MarineTraffic for the fourth most probable destination port from the given port of origin
NEXT_PORT_4	text	Fourth most probable destination port from the given port of origin
NEXT_PORT_4_PROB	real	The probability of visiting the fourth most likely destination port
NEXT_AREA_4	text	The area where the fourth most probable port is
NEXT_AREA_4_PROB	real	The probability of visiting the area where the predicted port is
NEXT_PORT_5_ID	integer	A uniquely assigned ID by MarineTraffic for the fifth most probable destination port from the given port of origin
NEXT_PORT_5	text	Fifth most probable destination port from the given port of origin
NEXT_PORT_5_PROB	real	The probability of visiting the fifith most likely destination port
NEXT_AREA_5	text	The area where the fifth most probable port is
NEXT_AREA_5_PROB	real	The probability of visiting the area where the predicted port is

Description: Receive a prediction of the vessels likely to arrive to a specific port

Endpoint URL: https://services.marinetraffic.com/api/predictive-arrivals/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
portid	yes	integer		The MarineTraffic ID of the port you wish to receive probable visits (found on the URL of the respective Port page).
market	no	text		Define market for which you would like to receive probable visits. 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	no	text		Define ship class for which you would like to receive probable visits.
probability	no	real		Define probability over which you would like to receive probable visits (accepted > 0.3)

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data

Typical API call:
https://services.marinetraffic.com/api/predictive-arrivals/YOUR-API-KEY/portid:value

Example API call:
https://services.marinetraffic.com/api/predictive-arrivals/bb6e6261b44aa8bcd8246928b11a8f02e8a2e805/portid:51

XML sample response [simple]

<PredictiveArrivals>
<PredictiveArrival IMO="8817564" SHIP_ID="213546" MMSI="240708000" SHIPNAME="AEGEAN III" SHIPCLASS="HANDYSIZE" MARKET="WET BULK" FROM_PORT_ID="5" FROM_PORT="ELEFSIS" NEXT_PORT_ID="51" NEXT_PORT="PATRA" NEXT_AREA="EMED" NEXT_PORT_PROB="0.786" NEXT_AREA_PROB="1.000" />
<PredictiveArrival IMO="9314466" SHIP_ID="213945" MMSI="240871000" SHIPNAME="AEGEAN BREEZE I" SHIPCLASS="HANDYSIZE" MARKET="WET BULK" FROM_PORT_ID="5" FROM_PORT="ELEFSIS" NEXT_PORT_ID="51" NEXT_PORT="PATRA" NEXT_AREA="EMED" NEXT_PORT_PROB="0.556" NEXT_AREA_PROB="1.000" />
</PredictiveArrivals>

CSV sample response [simple]

IMO, SHIP_ID, MMSI, SHIPNAME, SHIPCLASS, MARKET, FROM_PORT_ID, FROM_PORT, NEXT_PORT_ID, NEXT_PORT, NEXT_AREA, NEXT_PORT_PROB, NEXT_AREA_PROB
8817564,213546,240708000,AEGEAN III,HANDYSIZE,WET BULK,5,ELEFSIS,51,PATRA,EMED,0.786,1.000
9314466,213945,240871000,AEGEAN BREEZE I,HANDYSIZE,WET BULK,5,ELEFSIS,51,PATRA,EMED,0.556,1.000

Simplified JSON sample response [simple]

[["8817564","213546","240708000","AEGEAN III","HANDYSIZE","WET BULK","5","ELEFSIS","51","PATRA","EMED","0.786","1.000"],
["9314466","213945","240871000","AEGEAN BREEZE I","HANDYSIZE","WET BULK","5","ELEFSIS","51","PATRA","EMED","0.556","1.000"]]

JSON object sample response [simple]

[{"IMO":"8817564","SHIP_ID":"213546","MMSI":"240708000","SHIPNAME":"AEGEAN III","SHIPCLASS":"HANDYSIZE","MARKET":"WET BULK","FROM_PORT_ID":"5","FROM_PORT":"ELEFSIS","NEXT_PORT_ID":"51","NEXT_PORT":"PATRA","NEXT_AREA":"EMED","NEXT_PORT_PROB":"0.786","NEXT_AREA_PROB":"1.000"},
{"IMO":"9314466","SHIP_ID":"213945","MMSI":"240871000","SHIPNAME":"AEGEAN BREEZE I","SHIPCLASS":"HANDYSIZE","MARKET":"WET BULK","FROM_PORT_ID":"5","FROM_PORT":"ELEFSIS","NEXT_PORT_ID":"51",""NEXT_PORT":"PATRA","NEXT_AREA":"EMED","NEXT_PORT_PROB":"0.556","NEXT_AREA_PROB":"1.000"}]

Simple response

Field Name	Data Type	Description
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
SHIPNAME	text	The Shipname of the subject vessel
MARKET	text	The commercial market segment the subject vessel belongs to
SHIPCLASS	text	The class of the subject vessel based on vessel type and size
FROM_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the port that was used as origin to retrieve possible destinations
FROM_PORT	text	The port that was used as origin to retrieve possible destinations
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT	text	The target port used to predict arrivals of vessels
NEXT_AREA	text	The area where the target port belongs to
NEXT_PORT_PROB	real	The probability of visiting the target port
NEXT_AREA_PROB	real	The probability of visiting the area where the target port is

Description: Receive the Port Congestion for a specific period of time

Endpoint URL: https://services.marinetraffic.com/api/port-congestion/

Parameters

Parameter name	Required?	Type	Charge	Default value	Description
[no name]	yes	text			API key: 40-character hexadecimal number
protocol	no	text		xml	Response type. Use one of the following: xml, csv, json, jsono (object)
portid	yes	integer	simple		The MarineTraffic ID of the port you wish to receive probable visits (found on the URL of the respective Port page).
year	yes	integer	simple		Year of interest (data available back to 1 year). Information further back can be requested ad hoc
week	yes	integer or comma separated integers	simple		Week of Year that is of interest (e.g. for week 18/2018 input 18). For range of weeks use comma e.g. for weeks 30 to 35 (30,35)
market	yes	real	simple		Define market for which you would like to receive port congestion. If undefined and ship-class is also undefined, then figures for ALL markets/ship-class.. If undefined and ship-class is defined, returns based on ship-class for ALL applicable to size class markets. If defined and ship-class is undefined, returns figures for the specific market (no size class breakdown).
shipclass	yes	text	simple		Define ship class of interest.
agg_port	no	integer(0/1)	simple		If used, portid should not be in request. If agg_port = 1, aggregation result of all ports will be returned. If 0 a breakdown of ports will be returned. If agg_port = 1 agg_market cannot be 1..
agg_market	no	integer(0/1)	simple		If used, market should not be in request. If agg_market = 1, aggregation result of all markets will be returned. If 0 a breakdown of markets will be returned.
agg_shipclass	no	integer(0/1)	simple		If used, shipclass should not be in request. If agg_shipclass = 1, aggregation result of all classes will be returned. If 0 a breakdown of classes will be returned.
time_anch	no	Comma separated float numbers (one decimal)	extended		Define market for which you would like to receive port congestion. If undefined and ship-class is also undefined, then figures for ALL markets/ship-class.. If undefined and ship-class is defined, returns based on ship-class for ALL applicable to size class markets. If defined and ship-class is undefined, returns figures for the specific market (no size class breakdown).
time_port	no	Comma separated float numbers (one decimal)	extended		The median number of days spent at port by the selected market/shipclass. Values indicate in between set to be returned.
vessels	no	integer	extended		Number of vessels that were used in the median calculations. Value of parameter indicates greater than relation..
calls	no	integer	extended		Number of individual calls that were used in the median calculations (e.g. if the same vessel has called twice within the same week, it will count twice in calls and once in vessels. Value of parameter indicates greater than relation.
time_anch_stdev	no	Comma separated float numbers (one decimal)	full		The standard deviation of days spent at anchorage the previous week. Values indicate in between set to be returned (time_anch_stdev:0.5,1.5).
time_anch_diff	no	Comma separated float numbers (one decimal)	full		The week-to-week difference of number of days spent at anchorage. Values indicate in between set to be returned.
time_anch_diff_perc	no	Comma separated float numbers (one decimal)	full		The week-to-week difference of number of days spent at anchorage as a percentage.Values indicate in between set to be returned.
time_port_stdev	no	Comma separated float numbers (one decimal)	full		The standard deviation of days spent at port the previous week. Values indicate in between set to be returned (time_port_stdev:0.5,1.5).
time_port_diff	no	Comma separated float numbers (one decimal)	full		The week-to-week difference of number of days spent at port. Values indicate in between set to be returned.
time_anch_diff_perc	no	Comma separated float numbers (one decimal)	full		The week-to-week difference of number of days spent at port as a percentage. Values indicate in between set to be returned.

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
The API charges per record are based on the parameters used above. If there is a mix of parameters (simple,extended or full), then the parameter of greatest value is taken into account to calculate the API call cost.

NOT ALLOWED combinations in Request
agg_market:1/agg_shipclass:0
agg_market:1/agg_port:1
agg_shipclass:1/agg_port:1
agg_market:1/shipclass (Specific value in shipclass eg. shipclass:POST PANAMAX)

Example API call(1) -> simple cost:
https://services.marinetraffic.com/api/port-congestion/084dbc6f08c29132486fed4c1d61c96b732fb4/year:2018/market:wet bulk/shipclass:handysize/week:15/portid:1/

XML sample response [/protocol:xml/]

<PORTCONGESTION>
<PORT PORT_ID="1" YEAR="2018" WEEK="15" MARKET="WET BULK" SHIPCLASS="HANDYSIZE" TIME_ANCH="0.3" TIME_PORT="0.7" VESSELS="17" CALLS="33" TIME_ANCH_STDEV="1.1" TIME_ANCH_DIFF="0.1" TIME_ANCH_DIFF_PERC="50.0" TIME_PORT_STDEV="9.0" TIME_PORT_DIFF="0.0" TIME_PORT_DIFF_PERC="0.0"/>
</PORTCONGESTION>

CSV sample response [/protocol:csv/]

PORT_ID, YEAR, WEEK, MARKET, SHIPCLASS, TIME_ANCH, TIME_PORT, VESSELS, CALLS, TIME_ANCH_STDEV, TIME_ANCH_DIFF, TIME_ANCH_DIFF_PERC, TIME_PORT_STDEV, TIME_PORT_DIFF, TIME_PORT_DIFF_PERC
1,2018,15,WET BULK,HANDYSIZE,0.3,0.7,17,33,1.1,0.1,50.0,9.0,0.0,0.0

Simplified JSON sample response [/protocol:json/]

[["1","2018","15","WET BULK","HANDYSIZE","0.3","0.7","17","33","1.1","0.1","50.0","9.0","0.0","0.0"]]

JSON object sample response [/protocol:jsono/]

[{"PORT_ID":"1","YEAR":"2018","WEEK":"15","MARKET":"WET BULK","SHIPCLASS":"HANDYSIZE","TIME_ANCH":"0.3","TIME_PORT":"0.7","VESSELS":"17","CALLS":"33","TIME_ANCH_STDEV":"1.1","TIME_ANCH_DIFF":"0.1","TIME_ANCH_DIFF_PERC":"50.0","TIME_PORT_STDEV":"9.0","TIME_PORT_DIFF":"0.0","TIME_PORT_DIFF_PERC":"0.0"}]

Example API call(2) -> extended cost:
https://services.marinetraffic.com/api/port-congestion/084dbc6f08c29132486fed4c1d61c96b732fb4/year:2018/market:wet bulk/shipclass:handysize/week:15/portid:1/calls:20/vessels:10

XML sample response [/protocol:xml/]

<PORTCONGESTION>
<PORT PORT_ID="1" YEAR="2018" WEEK="15" MARKET="WET BULK" SHIPCLASS="HANDYSIZE" TIME_ANCH="0.3" TIME_PORT="0.7" VESSELS="17" CALLS="33" TIME_ANCH_STDEV="1.1" TIME_ANCH_DIFF="0.1" TIME_ANCH_DIFF_PERC="50.0" TIME_PORT_STDEV="9.0" TIME_PORT_DIFF="0.0" TIME_PORT_DIFF_PERC="0.0"/>
</PORTCONGESTION>

CSV sample response [/protocol:csv/]

PORT_ID, YEAR, WEEK, MARKET, SHIPCLASS, TIME_ANCH, TIME_PORT, VESSELS, CALLS, TIME_ANCH_STDEV, TIME_ANCH_DIFF, TIME_ANCH_DIFF_PERC, TIME_PORT_STDEV, TIME_PORT_DIFF, TIME_PORT_DIFF_PERC
1,2018,15,WET BULK,HANDYSIZE,0.3,0.7,17,33,1.1,0.1,50.0,9.0,0.0,0.0

Simplified JSON sample response [/protocol:json/]

[["1","2018","15","WET BULK","HANDYSIZE","0.3","0.7","17","33","1.1","0.1","50.0","9.0","0.0","0.0"]]

JSON object sample response [/protocol:jsono/]

[{"PORT_ID":"1","YEAR":"2018","WEEK":"15","MARKET":"WET BULK","SHIPCLASS":"HANDYSIZE","TIME_ANCH":"0.3","TIME_PORT":"0.7","VESSELS":"17","CALLS":"33","TIME_ANCH_STDEV":"1.1","TIME_ANCH_DIFF":"0.1","TIME_ANCH_DIFF_PERC":"50.0","TIME_PORT_STDEV":"9.0","TIME_PORT_DIFF":"0.0","TIME_PORT_DIFF_PERC":"0.0"}]

Example API call(3) -> full cost:
https://services.marinetraffic.com/api/port-congestion/084dbc6f08c29132486fed4c1d61c96b732fb4/year:2018/market:wet bulk/shipclass:handysize/week:15/portid:1/calls:20/vessels:10/time_anch_stdev:0.5,1.5/

XML sample response [/protocol:xml/]

<PORTCONGESTION>
<PORT PORT_ID="1" YEAR="2018" WEEK="15" MARKET="WET BULK" SHIPCLASS="HANDYSIZE" TIME_ANCH="0.3" TIME_PORT="0.7" VESSELS="17" CALLS="33" TIME_ANCH_STDEV="1.1" TIME_ANCH_DIFF="0.1" TIME_ANCH_DIFF_PERC="50.0" TIME_PORT_STDEV="9.0" TIME_PORT_DIFF="0.0" TIME_PORT_DIFF_PERC="0.0"/>
</PORTCONGESTION>

CSV sample response [/protocol:csv/]

PORT_ID, YEAR, WEEK, MARKET, SHIPCLASS, TIME_ANCH, TIME_PORT, VESSELS, CALLS, TIME_ANCH_STDEV, TIME_ANCH_DIFF, TIME_ANCH_DIFF_PERC, TIME_PORT_STDEV, TIME_PORT_DIFF, TIME_PORT_DIFF_PERC
1,2018,15,WET BULK,HANDYSIZE,0.3,0.7,17,33,1.1,0.1,50.0,9.0,0.0,0.0

Simplified JSON sample response [/protocol:json/]

[["1","2018","15","WET BULK","HANDYSIZE","0.3","0.7","17","33","1.1","0.1","50.0","9.0","0.0","0.0"]]

JSON object sample response [/protocol:jsono/]

[{"PORT_ID":"1","YEAR":"2018","WEEK":"15","MARKET":"WET BULK","SHIPCLASS":"HANDYSIZE","TIME_ANCH":"0.3","TIME_PORT":"0.7","VESSELS":"17","CALLS":"33","TIME_ANCH_STDEV":"1.1","TIME_ANCH_DIFF":"0.1","TIME_ANCH_DIFF_PERC":"50.0","TIME_PORT_STDEV":"9.0","TIME_PORT_DIFF":"0.0","TIME_PORT_DIFF_PERC":"0.0"}]

Other Example Calls

https://services.marinetraffic.com/api/port-congestion/084dbc6f08c29132486fed4c1d61c96b732fb4/portid:1/year:2018/week:15,20/market:CONTAINER SHIPS/shipclass:FEEDER

The above API call would return for every week between the 15th and 20th of 2018 the Port Congestion in port of Piraeus for the ship class FEEDER within the Container Ships Market

https://services.marinetraffic.com/api/port-congestion/084dbc6f08c29132486fed4c1d61c96b732fb4/year:2018/week:15/agg_market:0/agg_shipclass:0/agg_port:1

The above API call would return for the 15th week of 2018 the Port Congestion in all port for all ship classes and all markets

Response Fields

Field Name	Data Type	Description
PORT_ID	text	A uniquely assigned ID by MarineTraffic for the Current Port
YEAR	integer	Year of week the data are referring to
WEEK	integer	Week of year the data are referring to
MARKET	text	The commercial market segment the subject vessel belongs to
SHIPCLASS	text	The class of the subject vessel based on vessel type and size
TIME_ANCH	real	The median number of days spent at anchorage the previous week
TIME_PORT	real	The median number of days spent at port by the selected market/shipclass
VESSELS	integer	Number of vessels that were used in the median calculations
CALLS	integer	Number of individual calls that were used in the median calculations (e.g. if the same vessel has called twice within the same week, it will count twice in CALLS and once in VESSELS
TIME_ANCH_STDEV	real	The week-to-week standard deviation in days spent at anchorage
TIME_ANCH_DIFF	real	The week-to-week difference of number of days spent at anchorage
TIME_ANCH_DIFF_PERC	real	The week-to-week difference of number of days spent at anchorage as a percentage
TIME_PORT_STDEV	real	The week-to-week standard deviation in days spent at port
TIME_PORT_DIFF	real	The week-to-week difference of number of days spent at port
TIME_PORT_DIFF_PERC	real	The week-to-week difference of number of days spent at port as a percentage

Description: ETA to Port

Endpoint URL: https://services.marinetraffic.com/api/etatoport/v:2/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
msgtype	no	text	simple	If used with the value extended, the response includes voyage related data.
portid	yes (only use one of two)	integer		The MarineTraffic ID of the port you wish to receive ETA info.
unlocode	yes (only use one of two)	text		The UN LOCODE (without gaps or spaces) of the port you wish to receive ETA info.
shipid	yes (only use one of three)	integer		The MarineTraffic ID of the vessel you wish to monitor found on the URL of the respective Vessel page.
imo		integer		The International Maritime Organization (IMO) number of the vessel you wish to track.
mmsi		integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track.
speed_calc	no	real	12	The Speed of the Vessel that MarineTraffic will use to produce the ETA value. If 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.

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data

Example API call(1) -> simple cost:
https://services.marinetraffic.com/en/api/etatoport/vq2qwlotil09zhgi2xjyzvuf5hd6irw88cq8gxtn/v:2/portid:2036/shipid:292/speed_calc:18.8/msgtype:simple

XML sample response [/protocol:xml/]

<ETATOPORT>
<ETATOPORT_ROW  SHIP_ID="292" MMSI="228313800" IMO="9450600" LAST_PORT_ID="166" LAST_PORT="CAPE TOWN" LAST_PORT_UNLOCODE="ZACPT" LAST_PORT_TIME="2018-12-08 08:13:00" NEXT_PORT_NAME="ROTTERDAM" NEXT_PORT_UNLOCODE="NLRTM" ETA_CALC="2018-12-26 11:47:12" ETA_PORT_NAME="ROTTERDAM" ETA_PORT_UNLOCODE="NLRTM" />

</ETATOPORT>

CSV sample response [/protocol:csv/]

SHIP_ID, MMSI, IMO, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA_CALC, ETA_PORT_NAME, ETA_PORT_UNLOCODE 
292,228313800,9450600,166,CAPE TOWN,ZACPT,2018-12-08 08:13:00,ROTTERDAM,NLRTM,2018-12-26 11:47:12,ROTTERDAM,NLRTM

Simplified JSON sample response [/protocol:json/]

[["292","228313800","9450600","166","CAPE TOWN","ZACPT","2018-12-08 08:13:00","ROTTERDAM","NLRTM","2018-12-26 11:47:12","ROTTERDAM","NLRTM"]]

JSON object sample response [/protocol:jsono/]

[{"SHIP_ID":"292","MMSI":"228313800","IMO":"9450600","LAST_PORT_ID":"166","LAST_PORT":"CAPE TOWN","LAST_PORT_UNLOCODE":"ZACPT","LAST_PORT_TIME":"2018-12-08 08:13:00","NEXT_PORT_NAME":"ROTTERDAM","NEXT_PORT_UNLOCODE":"NLRTM","ETA_CALC":"2018-12-26 11:48:2","ETA_PORT_NAME":"ROTTERDAM","ETA_PORT_UNLOCODE":"NLRTM",}]

Example API call(2) -> extended cost:
https://services.marinetraffic.com/en/api/etatoport/vq2qwlotil09zhgi2xjyzvuf5hd6irw88cq8gxtn/v:2/portid:2036/shipid:292/speed_calc:18.8/msgtype:extended

XML sample response [/protocol:xml/]

<ETATOPORT>
<ETATOPORT_ROW SHIP_ID="292" MMSI="228313800" IMO="9450600" LAST_PORT_ID="166" LAST_PORT="CAPE TOWN" LAST_PORT_UNLOCODE="ZACPT" LAST_PORT_TIME="2018-12-08 08:13:00" NEXT_PORT_NAME="ROTTERDAM" NEXT_PORT_UNLOCODE="NLRTM" ETA_CALC="2018-12-26 11:47:12" ETA_PORT_NAME="ROTTERDAM" ETA_PORT_UNLOCODE="NLRTM" DISTANCE_TRAVELLED="2018-12-26 11:48:2" DISTANCE_TO_GO="2018-12-26 11:48:2" SPEED_CALC="2018-12-26 11:48:2" DRAUGHT="2018-12-26 11:48:2" DRAUGHT_MAX="2018-12-26 11:48:2" LOAD_STATUS_NAME="2018-12-26 11:48:2" ROUTE="2018-12-26 11:48:2" ETD_CALC="2018-12-26 11:48:2" TIME_ANCH="2018-12-26 11:48:2" TIME_PORT="2018-12-26 11:48:2" />
</ETATOPORT>

CSV sample response [/protocol:csv/]

SHIP_ID, MMSI, IMO, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA_CALC, ETA_PORT_NAME, ETA_PORT_UNLOCODE DISTANCE_TRAVELLED, DISTANCE_TO_GO, SPEED_CALC, DRAUGHT, DRAUGHT_MAX, LOAD_STATUS_NAME, ROUTE, ETD_CALC, TIME_ANCH, TIME_PORT
292,228313800,9450600,166,CAPE TOWN,ZACPT,2018-12-08 08:13:00,ROTTERDAM,NLRTM,2018-12-26 11:53:34,ROTTERDAM,NLRTM,528,4976,165,116,144,PARTIALLY_LADEN,DIR,2018-12-27 07:05:34,0,0.8

Simplified JSON sample response [/protocol:json/]

[["292","228313800","9450600","166","CAPE TOWN","ZACPT","2018-12-08 08:13:00","ROTTERDAM","NLRTM","2018-12-26 11:53:59","ROTTERDAM","NLRTM","528","4976","165","116","144","PARTIALLY_LADEN","DIR","2018-12-27 07:05:59",0,0.8]]

JSON object sample response [/protocol:jsono/]

[{"SHIP_ID":"292","MMSI":"228313800","IMO":"9450600","LAST_PORT_ID":"166","LAST_PORT":"CAPE TOWN","LAST_PORT_UNLOCODE":"ZACPT","LAST_PORT_TIME":"2018-12-08 08:13:00","NEXT_PORT_NAME":"ROTTERDAM","NEXT_PORT_UNLOCODE":"NLRTM","ETA_CALC":"2018-12-26 11:48:2","ETA_PORT_NAME":"ROTTERDAM","ETA_PORT_UNLOCODE":"NLRTM","DISTANCE_TRAVELLED":"2018-12-26 11:48:2","DISTANCE_TO_GO":"2018-12-26 11:48:2","SPEED_CALC":"2018-12-26 11:48:2","DRAUGHT":"2018-12-26 11:48:2","DRAUGHT_MAX":"2018-12-26 11:48:2","LOAD_STATUS_NAME":"2018-12-26 11:48:2","ROUTE":"2018-12-26 11:48:2","ETD_CALC":"2018-12-26 11:48:2","TIME_ANCH":"2018-12-26 11:48:2","TIME_PORT":"2018-12-26 11:48:2"}]

Simple response

Field Name	Data Type	Description
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations
ETA_PORT_NAME	text	The name of the Port that was provided by the user as input parameter during the API call and that was used by MarineTraffic for ETA and voyage calculations
ETA_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Port that was provided by the user as input parameter during the API call and that was used by MarineTraffic for ETA and voyage calculations

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
SPEED_CALC	real	The Speed of the vessel that MarineTraffic used to produce the ETA_CALC value
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
DRAUGHT_MAX	integer	The Maximum Draught that has been recorded for the subject vessel
LOAD_STATUS_NAME	text	The Load Condition of the subject vessel (In Ballast, Partially Loaded, Loaded)
ROUTE	text	The estimated route of the subject vessel to destination in WKT format
ETD_CALC	date	The Estimated Time of Departure from a Destination of the subject vessel according to the MarineTraffic calculations based on calculated eta, time at anchorage & time at port
TIME_ANCH	real	The median number of days spent at anchorage the previous week
TIME_PORT	real	The median number of days spent at port by the selected market/shipclass

Service info

Description:Change Fleet

Call requires API Key. Also requires MMSI or IMO or SHIP ID and either the active or delete parameter.

To create a new item in a fleet, use the active parameter. If the item already exists, it will update item's status.
The active parameter can have values of 0,1,2 which corresponds to the three states of the fleet items (inactive, active, sat enabled)

The delete parameter must have a value of 1 and it removes the entry from the fleet.

If MMSI, IMO and SHIP ID are passed, the MMSI takes precedence and the IMO and SHIP ID will be ignored.

If more than one vessels are found with the same parameter (MMSI, IMO, SHIP ID) then an error message is return with all the available vessels.

Response is always an XML structure indicating success or failure with failure description message.

Endpoint URL: https://services.marinetraffic.com/api/setfleet/

Parameters

Parameter name	Required?	Type	Description
[no name]	yes	text	API key: 40-character hexadecimal number
mmsi	yes (use one of the three)	integer	The Maritime Mobile Service Identity (MMSI) of the vessel you wish to handle.
imo			The International Maritime Organization (IMO) number of the vessel you wish to handle.
shipid			A uniquely assigned ID by MarineTraffic for the subject vessel.
fleet_id	no	integer	If used, vessel will be added to the specific fleet, otherwise default fleet is used.
active	yes (use one of the two)	integer	Possible values are: 0 to set to inactive, 1 to activate, 2 to enable sat coverage.
delete	yes (use one of the two)	integer	Set this parameter to 1 to delete a vessel from your fleet.

Notes

Ensure your client or library is configured to handle redirects

Typical API call:
https://services.marinetraffic.com/api/setfleet/YOUR-API-KEY/mmsi:value/active:value

Example API calls:

Deactivates vessel. https://services.marinetraffic.com/api/setfleet/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:1234567890/active:0

Activates terrestrial tracking for vessel. https://services.marinetraffic.com/api/setfleet/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:1234567890/active:1

Removes vessel from fleet. https://services.marinetraffic.com/api/setfleet/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:1234567890/delete:1

Sample responses

<RESPONSE>
<STATUS>
<SUCCESS CODE="7" DESCRIPTION="FLEET ITEM UPDATED" />
</STATUS>
</RESPONSE>

<RESPONSE>
<STATUS>
<ERROR CODE="21" DESCRIPTION="VESSEL NOT FOUND IN FLEET" />
</STATUS>
</RESPONSE>

Simple response

Field Name	Data Type	Description
CODE	text	Code Status
DESCRIPTION	text	Code Description

Description: Vessels in a Fleet

Endpoint URL: https://services.marinetraffic.com/api/getfleet/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
fleet_id	no	integer		If used, will return specific fleet otherwise default fleet is used

Notes

Ensure your client or library is configured to handle redirects

Typical API call:
https://services.marinetraffic.com/api/getfleet/YOUR-API-KEY/protocol:value

Example API call:
https://services.marinetraffic.com/api/getfleet/8205c862d0572op1655989d939f1496c092ksvs4/protocol:xml

XML sample response

<FLEET INACTIVE="2" TERRESTRIAL="4" SATELLITE="1">
<VESSEL SHIP_ID="319" MMSI="228316700" IMO="9387542" SHIPNAME="KAOMBO NORTE" ACTIVE="1"/>
<VESSEL SHIP_ID="326" MMSI="256609000" IMO="9409156" SHIPNAME="LAPEROUSE" ACTIVE="1"/>
<VESSEL SHIP_ID="487" MMSI="228333700" IMO="9320075" SHIPNAME="GASELYS" ACTIVE="1"/>
<VESSEL SHIP_ID="510" MMSI="228337700" IMO="9306495" SHIPNAME="PROVALYS" ACTIVE="1"/>
<VESSEL SHIP_ID="1595" MMSI="229036000" IMO="9529475" SHIPNAME="PETALIDI" ACTIVE="1"/>
</FLEET>

CSV sample response

SHIP_ID, MMSI, IMO, SHIPNAME, ACTIVE
319,228316700,9387542,KAOMBO NORTE,1
326,256609000,9409156,LAPEROUSE,1
487,228333700,9320075,GASELYS,1
510,228337700,9306495,PROVALYS,1
1595,229036000,9529475,PETALIDI,1

Simplified JSON sample response

[["319","228316700","9387542","KAOMBO NORTE","1"],
[{"326","256609000","9409156","LAPEROUSE","1"],
[{"487","228333700","9320075","GASELYS","1"],
[{"510","228337700","9306495","PROVALYS","1"],
[{"1595","229036000","9529475","PETALIDI","1"]]

JSON object sample response [simple]

[{"SHIP_ID":"319","MMSI":"228316700","IMO":"9387542","SHIPNAME":"KAOMBO NORTE","ACTIVE":"1"},
{"SHIP_ID":"326","MMSI":"256609000","IMO":"9409156","SHIPNAME":"LAPEROUSE","ACTIVE":"1"},
{"SHIP_ID":"487","MMSI":"228333700","IMO":"9320075","SHIPNAME":"GASELYS","ACTIVE":"1"},
{"SHIP_ID":"510","MMSI":"228337700","IMO":"9306495","SHIPNAME":"PROVALYS","ACTIVE":"1"},
{"SHIP_ID":"1595","MMSI":"229036000","IMO":"9529475","SHIPNAME":"PETALIDI","ACTIVE":"1"}]

Simple response

Field Name	Data Type	Description
SHIP_ID	integer	A uniquely assigned ID by MarineTraffic for the subject vessel
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
IMO	integer	International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIPNAME	text	The Shipname of the subject vessel
ACTIVE	integer	The Status of the subject vessel (Off = 0, Terrestrial = 1, Satellite = 2 )

Description: Fleets

Endpoint URL: https://services.marinetraffic.com/api/getfleets/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)

Notes

Ensure your client or library is configured to handle redirects

Typical API call:
https://services.marinetraffic.com/api/getfleets/YOUR-API-KEY/protocol:value

Example API call:
https://services.marinetraffic.com/api/getfleets/8205c862d0572op1655989d939f1496c092ksvs4/protocol:xml

XML sample response

<FLEETS>
	<FLEET ID="740000" NAME="My First Fleet" ACTIVE="1" CREATED="2015-03-05 15:09:00" DEFAULT="1"/>
	<FLEET ID="740001" NAME="My Fleet2" ACTIVE="1" CREATED="2015-04-05 15:09:00" DEFAULT="0"/>
</FLEETS>

CSV sample response

ID, NAME, ACTIVE, CREATED, DEFAULT
740000,My First Fleet,1,2015-03-05 15:09:00,1
740001,My Fleet2,1,2015-04-05 15:09:00,0

Simplified JSON sample response

[["740000","My First Fleet","1","2015-03-05 15:09:00","1"],
[["740001","My Fleet2","1","2015-04-05 15:09:00","0"]

JSON object sample response [simple]

[{"ID":"740000","NAME":"My First Fleet","ACTIVE":"1","CREATED":"2015-03-05 15:09:00","DEFAULT":"1"},
{"ID":"740001","NAME":"My Fleet2","ACTIVE":"1","CREATED":"2015-04-05 15:09:00","DEFAULT":"0"}]

Simple response

Field Name	Data Type	Description
ID	integer	A uniquely assigned ID by MarineTraffic for the subject Fleet
NAME	text	The Name of the subject Fleet
ACTIVE	integer	The Status of the subject Fleet (1 = Active )
CREATED	date	The Date and Time (in UTC) that the subject Fleet was created
DEFAULT	integer	1 = Default Fleet

Description: Vessel Events

Endpoint URL: https://services.marinetraffic.com/api/vesselevents/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no (use timespan OR fromdate and todate)	integer	60	The maximum age, in minutes, of the returned events. Maximum value is 2880.
fromdate		datetime		Vessel Events between fromdate and todate. Date format: YYYY-MM-DD HH:MM:SS
todate		datetime
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
mmsi	yes (only use one of the three)	integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track.
imo				The International Maritime Organization (IMO) number of the vessel you wish to track.
shipid				A uniquely assigned ID by MarineTraffic for the subject vessel.
event_type	no	integer/text		You may use one or more event ids in comma separated format for the events you wish to receive. More info about event types here.
limit_events	no	integer		Limit the number of results.

Notes

Ensure your client or library is configured to handle redirects
More information about event types here
Information about AIS-transmitted data

Typical API call:
https://services.marinetraffic.com/api/vesselevents/YOUR-API-KEY/mmsi:value/event_type:#ids/timespan:#minutes/

Example #1 API call:
https://services.marinetraffic.com/api/vesselevents/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:355906000/event_type:19/limit_events:2/timespan:160

XML sample response [simple]

<EVENTS>
<EVENT SHIPNAME="MSC OSCAR" MMSI="355906000" EVENT_ID="19" EVENT_NAME="PROXIMITY_VESSEL" EVENT_CONTENT="Distance from vessel ALG.PILOTS GETARES is 666m" TIMESTAMP="2016-04-10T09:41:00" />
<EVENT SHIPNAME="MSC OSCAR" MMSI="355906000" EVENT_ID="19" EVENT_NAME="PROXIMITY_VESSEL" EVENT_CONTENT="Distance from vessel VB SIMUN is 258m" TIMESTAMP="2016-04-10T09:41:00" />
</EVENTS>

CSV sample response [simple]

SHIPNAME, MMSI, EVENT_ID, EVENT_NAME, EVENT_CONTENT, TIMESTAMP
MSC OSCAR,355906000,19,PROXIMITY_VESSEL,Distance from vessel ALG.PILOTS GETARES is 666m,2016-04-10T09:41:00
MSC OSCAR,355906000,19,PROXIMITY_VESSEL,Distance from vessel VB SIMUN is 258m,2016-04-10T09:41:00

Simplified JSON sample response [simple]

[["MSC OSCAR","355906000","19","PROXIMITY_VESSEL","Distance from vessel ALG.PILOTS GETARES is 666m","2016-04-10T09:41:00"]
["MSC OSCAR","355906000","19","PROXIMITY_VESSEL","Distance from vessel VB SIMUN is 258m","2016-04-10T09:41:00"]]

JSON object sample response [simple]

[{"SHIPNAME":"MSC OSCAR","MMSI":"355906000","EVENT_ID":"19","EVENT_NAME":"PROXIMITY_VESSEL","EVENT_CONTENT":"Distance from vessel ALG.PILOTS GETARES is 666m","TIMESTAMP":"2016-04-10T09:41:00"},
{"SHIPNAME":"MSC OSCAR","MMSI":"355906000","EVENT_ID":"19","EVENT_NAME":"PROXIMITY_VESSEL","EVENT_CONTENT":"Distance from vessel VB SIMUN is 258m","TIMESTAMP":"2016-04-10T09:41:00"}]

Example #2 API call:
https://services.marinetraffic.com/api/vesselevents/v:1/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:355906000/event_type:2,19/timespan:160

XML sample response [simple]

<EVENTS>
<EVENT SHIPNAME="MSC OSCAR" MMSI="355906000" EVENT_ID="2" EVENT_NAME="INTERMEDIATE_DAILY_POS" EVENT_CONTENT="At Lat:35.9598 / Lon:-6.02252" TIMESTAMP="2016-04-10T12:02:00" />
<EVENT SHIPNAME="MSC OSCAR" MMSI="355906000" EVENT_ID="19" EVENT_NAME="PROXIMITY_VESSEL" EVENT_CONTENT="Distance from vessel VB SIMUN is 258m" TIMESTAMP="2016-04-10T09:41:00" />
<EVENT SHIPNAME="MSC OSCAR" MMSI="355906000" EVENT_ID="19" EVENT_NAME="PROXIMITY_VESSEL" EVENT_CONTENT="Distance from vessel VB TRON is 389m" TIMESTAMP="2016-04-10T09:41:00" />
</EVENTS>

CSV sample response [simple]

SHIPNAME, MMSI, EVENT_ID, EVENT_NAME, EVENT_CONTENT, TIMESTAMP
MSC OSCAR,355906000,2,INTERMEDIATE_DAILY_POS,At Lat:35.9598 / Lon:-6.02252,2016-04-10T12:02:00
MSC OSCAR,355906000,19,PROXIMITY_VESSEL,Distance from vessel VB SIMUN is 258m,2016-04-10T09:41:00
MSC OSCAR,355906000,19,PROXIMITY_VESSEL,Distance from vessel VB TRON is 389m,2016-04-10T09:41:00

Simplified JSON sample response [simple]

[["MSC OSCAR","355906000","2","INTERMEDIATE_DAILY_POS","At Lat:35.9598 \/ Lon:-6.02252","2016-04-10T12:02:00"]
["MSC OSCAR","355906000","19","PROXIMITY_VESSEL","Distance from vessel VB SIMUN is 258m","2016-04-10T09:41:00"]
["MSC OSCAR","355906000","19","PROXIMITY_VESSEL","Distance from vessel VB TRON is 389m","2016-04-10T09:41:00"]]

JSON object sample response [simple]

[{"SHIPNAME":"MSC OSCAR","MMSI":"355906000","EVENT_ID":"2","EVENT_NAME":"INTERMEDIATE_DAILY_POS","EVENT_CONTENT":"At Lat:35.9598 / Lon:-6.02252","TIMESTAMP":"2016-04-10T12:02:00"},
{"SHIPNAME":"MSC OSCAR","MMSI":"355906000","EVENT_ID":"19","EVENT_NAME":"PROXIMITY_VESSEL","EVENT_CONTENT":"Distance from vessel VB SIMUN is 258m","TIMESTAMP":"2016-04-10T09:41:00"},
{"SHIPNAME":"MSC OSCAR","MMSI":"355906000","EVENT_ID":"19","EVENT_NAME":"PROXIMITY_VESSEL","EVENT_CONTENT":"Distance from vessel VB TRON is 389m","TIMESTAMP":"2016-04-10T09:41:00"}]

Simple response

Field Name	Data Type	Description
SHIPNAME	text	The Shipname of the subject vessel
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
EVENT_ID	integer	The ID of the subject event - more
EVENT_NAME	text	The Name of the subject Event
EVENT_CONTENT	text	The description of the subject Event
TIMESTAMP	date	The date and time (in UTC) that the subject Event was recorded by MarineTraffic

Description: Voyage Forecasts

Endpoint URL: https://services.marinetraffic.com/api/voyageforecast/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
msgtype	no	text	simple	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.
mmsi	yes (only use one of the four)	integer		The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track.
imo				The International Maritime Organization (IMO) number of the vessel you wish to track.
shipid				A uniquely assigned ID by MarineTraffic for the subject vessel.
fleet_id				The fleet id you wish to receive voyage forecast for.

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data
SPEED returned in (knots x10) and TIMESTAMP in UTC

Typical API call:
https://services.marinetraffic.com/api/voyageforecast/YOUR-API-KEY/mmsi:value

Example API call:
https://services.marinetraffic.com/api/voyageforecast/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:355906000

XML sample response [simple]

<FORECASTS>
<FORECAST MMSI="355906000" DESTINATION="TANGER MED" LAST_PORT_ID="2037" LAST_PORT="ROTTERDAM MAASVLAKTE" LAST_PORT_UNLOCODE="NLMSV" LAST_PORT_TIME="2016-04-19T03:11:00" NEXT_PORT_ID="1099" NEXT_PORT_NAME="TANGER MED" NEXT_PORT_UNLOCODE="MAPTM" ETA="2016-04-24T08:00:00" ETA_CALC="2016-04-25T01:50:00" />
</FORECASTS>

XML sample response [extended]

<FORECASTS>
<FORECAST MMSI="355906000" DESTINATION="TANGER MED" LAST_PORT_ID="2037" LAST_PORT="ROTTERDAM MAASVLAKTE" LAST_PORT_UNLOCODE="NLMSV" LAST_PORT_TIME="2016-04-19T03:11:00" NEXT_PORT_ID="1099" NEXT_PORT_NAME="TANGER MED" NEXT_PORT_UNLOCODE="MAPTM" ETA="2016-04-24T08:00:00" ETA_CALC="2016-04-25T01:50:00" DISTANCE_TRAVELLED="112" DISTANCE_TO_GO="1367" SPEED_CALC="103" DRAUGHT="106" DRAUGHT_MAX="160" LOAD_STATUS_NAME="IN_BALLAST" ROUTE="LINESTRING (1.3061 51.9496, 1.3198 51.9253, 1.5319 51.9358, 1.5484 51.9297, 1.5628 51.9072, 1.5685 51.8651, 1.6181 51.8556, 1.7286 51.8272, 1.7608 51.6416, 1.8051 51.546, 1.8844 51.4768, 1.9062 51.4114, 1.7662 51.2317, 1.5251 51.108, 1.4385 51.0599, 1.3317 51.0018, 0.5845 50.6069, -1.3323 50.2716, -2.9896 49.9666, -3.9515 49.6075, -4.5608 49.376, -5.7686 48.8919, -7.0977 47.3094, -9.2948 44.3644, -10.0952 43.2789, -10.1024 42.2256, -10.0907 41.1925, -10.0974 39.8082, -10.0934 38.716, -9.7988 37.6639, -9.5553 36.7994, -9.3081 36.5738, -8.1363 36.2893, -6.2082 35.9012, -5.7619 35.9011, -5.5676 35.9165, -5.5384 35.9225, -5.519 35.9244, -5.5015 35.9219, -5.4886 35.9094, -5.49 35.9048)" />
</FORECASTS>

CSV sample response [simple]

MMSI, DESTINATION, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_ID, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA, ETA_CALC
355906000,TANGER MED,2037,ROTTERDAM MAASVLAKTE,NLMSV,2016-04-19T03:11:00,1099,TANGER MED,MAPTM,2016-04-24T08:00:00,2016-04-25T01:50:00

CSV sample response [extended]

MMSI, DESTINATION, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_ID, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA, ETA_CALC, DISTANCE_TRAVELLED, DISTANCE_TO_GO, SPEED_CALC, DRAUGHT, DRAUGHT_MAX, LOAD_STATUS_NAME, ROUTE
355906000,TANGER MED,2037,ROTTERDAM MAASVLAKTE,NLMSV,2016-04-19T03:11:00,1099,TANGER MED,MAPTM,2016-04-24T08:00:00,2016-04-25T01:50:00,112,1367,103,106,160,IN_BALLAST,LINESTRING (1.3061 51.9496 1.3198 51.9253 1.5319 51.9358 1.5484 51.9297 1.5628 51.9072 1.5685 51.8651 1.6181 51.8556 1.7286 51.8272 1.7608 51.6416 1.8051 51.546 1.8844 51.4768 1.9062 51.4114 1.7662 51.2317 1.5251 51.108 1.4385 51.0599 1.3317 51.0018 0.5845 50.6069 -1.3323 50.2716 -2.9896 49.9666 -3.9515 49.6075 -4.5608 49.376 -5.7686 48.8919 -7.0977 47.3094 -9.2948 44.3644 -10.0952 43.2789 -10.1024 42.2256 -10.0907 41.1925 -10.0974 39.8082 -10.0934 38.716 -9.7988 37.6639 -9.5553 36.7994 -9.3081 36.5738 -8.1363 36.2893 -6.2082 35.9012 -5.7619 35.9011 -5.5676 35.9165 -5.5384 35.9225 -5.519 35.9244 -5.5015 35.9219 -5.4886 35.9094 -5.49 35.9048)

Simplified JSON sample response [simple]

[["355906000","TANGER MED","2037","ROTTERDAM MAASVLAKTE","NLMSV","2016-04-19T03:11:00","1099","TANGER MED","MAPTM","2016-04-24T08:00:00","2016-04-25T01:50:00"]]

Simplified JSON sample response [extended]

[["355906000","TANGER MED","2037","ROTTERDAM MAASVLAKTE","NLMSV","2016-04-19T03:11:00","1099","TANGER MED","MAPTM","2016-04-24T08:00:00","2016-04-25T01:50:00","112","1368","103","106","160","IN_BALLAST","LINESTRING (1.3061 51.9496, 1.3198 51.9253, 1.5319 51.9358, 1.5484 51.9297, 1.5628 51.9072, 1.5685 51.8651, 1.6181 51.8556, 1.7286 51.8272, 1.7608 51.6416, 1.8051 51.546, 1.8844 51.4768, 1.9062 51.4114, 1.7662 51.2317, 1.5251 51.108, 1.4385 51.0599, 1.3317 51.0018, 0.5845 50.6069, -1.3323 50.2716, -2.9896 49.9666, -3.9515 49.6075, -4.5608 49.376, -5.7686 48.8919, -7.0977 47.3094, -9.2948 44.3644, -10.0952 43.2789, -10.1024 42.2256, -10.0907 41.1925, -10.0974 39.8082, -10.0934 38.716, -9.7988 37.6639, -9.5553 36.7994, -9.3081 36.5738, -8.1363 36.2893, -6.2082 35.9012, -5.7619 35.9011, -5.5676 35.9165, -5.5384 35.9225, -5.519 35.9244, -5.5015 35.9219, -5.4886 35.9094, -5.49 35.9048)"]]

JSON object sample response [simple]

[{"MMSI":"355906000","DESTINATION":"TANGER MED","LAST_PORT_ID":"2037","LAST_PORT":"ROTTERDAM MAASVLAKTE","LAST_PORT_UNLOCODE":"NLMSV","LAST_PORT_TIME":"2016-04-19T03:11:00","NEXT_PORT_ID":"1099","NEXT_PORT_NAME":"TANGER MED","NEXT_PORT_UNLOCODE":"MAPTM","ETA":"2016-04-24T08:00:00","ETA_CALC":"2016-04-25T01:50:00"}]

JSON object sample response [extended]

[{"MMSI":"355906000","DESTINATION":"TANGER MED","LAST_PORT_ID":"2037","LAST_PORT":"ROTTERDAM MAASVLAKTE","LAST_PORT_UNLOCODE":"NLMSV","LAST_PORT_TIME":"2016-04-19T03:11:00","NEXT_PORT_ID":"1099","NEXT_PORT_NAME":"TANGER MED","NEXT_PORT_UNLOCODE":"MAPTM","ETA":"2016-04-24T08:00:00","ETA_CALC":"2016-04-25T01:50:00","DISTANCE_TRAVELLED":"112","DISTANCE_TO_GO":"1367","SPEED_CALC":"103","DRAUGHT":"106","DRAUGHT_MAX":"160","LOAD_STATUS_NAME":"IN_BALLAST","ROUTE":"LINESTRING (1.3061 51.9496, 1.3198 51.9253, 1.5319 51.9358, 1.5484 51.9297, 1.5628 51.9072, 1.5685 51.8651, 1.6181 51.8556, 1.7286 51.8272, 1.7608 51.6416, 1.8051 51.546, 1.8844 51.4768, 1.9062 51.4114, 1.7662 51.2317, 1.5251 51.108, 1.4385 51.0599, 1.3317 51.0018, 0.5845 50.6069, -1.3323 50.2716, -2.9896 49.9666, -3.9515 49.6075, -4.5608 49.376, -5.7686 48.8919, -7.0977 47.3094, -9.2948 44.3644, -10.0952 43.2789, -10.1024 42.2256, -10.0907 41.1925, -10.0974 39.8082, -10.0934 38.716, -9.7988 37.6639, -9.5553 36.7994, -9.3081 36.5738, -8.1363 36.2893, -6.2082 35.9012, -5.7619 35.9011, -5.5676 35.9165, -5.5384 35.9225, -5.519 35.9244, -5.5015 35.9219, -5.4886 35.9094, -5.49 35.9048)"}]

Simple response

Field Name	Data Type	Description
MMSI	integer	Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency that identifies the vessel's transmitter station
DESTINATION	text	The Destination of the subject vessel according to the AIS transmissions
LAST_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT	text	The Name of the Last Port the vessel has visited
LAST_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_TIME	date	The Date and Time (in UTC) that the subject vessel departed from the Last Port
NEXT_PORT_ID	integer	A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_NAME	text	The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_UNLOCODE	text	A uniquely assigned ID by United Nations for the Next Port
ETA	date	The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
ETA_CALC	date	The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic calculations

Extended response

( Including all Simple response fields )

Field Name	Data Type	Description
DISTANCE_TRAVELLED	integer	The Distance (in NM) that the subject vessel has travelled since departing from Last Port
DISTANCE_TO_GO	integer	The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
SPEED_CALC	integer	The Speed of the vessel that MarineTraffic used to produce the ETA_CALC value
DRAUGHT	integer	The Draught (in metres x10) of the subject vessel according to the AIS transmissions
DRAUGHT_MAX	integer	The Maximum Draught that has been recorded for the subject vessel
LOAD_STATUS_NAME	text	The Load Condition of the subject vessel (In Ballast, Partially Loaded, Loaded)
ROUTE	text	The estimated route of the subject vessel to destination in WKT format

Service info

Description: Credits Balance

Endpoint URL: https://services.marinetraffic.com/api/exportcredits/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number

Notes

Ensure your client or library is configured to handle redirects

Typical API call:
https://services.marinetraffic.com/api/exportcredits/YOUR-API-KEY/

Examples API call:
https://services.marinetraffic.com/api/exportcredits/8205c862d0572op1655989d939f1496c092ksvs4/

XML Sample response

<CREDITS USER_ID="13541873" CREDIT_BALANCE="1542" LAST_CHARGED="2017-01-17T12:23:24" />

CSV sample response

USER_ID, CREDIT_BALANCE,LAST_CHARGED
13541873,1542,2017-01-17T12:23:24

Simplified JSON sample response

[["13541873",1542,"2017-01-27T15:23:24"]]

JSON object sample response [simple]

[{"USER_ID":"13541873","CREDIT_BALANCE":"1542","LAST_CHARGED:"2017-01-27T15:23:24"}]

Simple response

Field Name	Data Type	Description
USER_ID	integer	A uniquely assigned ID by MarineTraffic for the subject MarineTraffic registered user
CREDIT_BALANCE	integer	The current Credits balance of the user
LAST_CHARGED	date	The last date and time (in UTC) that the user purchased Credits

Service info

Description: Clear Fleet

Endpoint URL: https://services.marinetraffic.com/api/clearfleet/

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
fleet_id	yes	integer		The fleet id you wish to receive voyage forecast for.

Notes

Ensure your client or library is configured to handle redirects

Typical API call:
https://services.marinetraffic.com/api/clearfleet/YOUR-API-KEY/fleet_id:value

Examples API call:
https://services.marinetraffic.com/api/clearfleet/8205c862d0572op1655989d939f1496c092ksvs4/fleet_id:1073568

XML sample response

<FLEET FLEET_ID="1073568" DELETE="1" />

CSV sample response

FLEET_ID,DELETE
1073568,1

Simplified JSON sample response

[["1073568","1"]]

JSON object sample response [simple]

[{"FLEET_ID":"1073568","DELETE":"1"}]

Simple response

Field Name	Data Type	Description
FLEET_ID	integer	The fleet_id you wish to clear
DELETE	integer	Indicates whether the vessels were successfully deleted from a fleet. Possible values: 0

Service info

Description: Import Passage Plan

Endpoint URL: https://services.marinetraffic.com/api/import-passage-plan/YOUR-API-KEY/

Request Type: POST

Body

Parameter name	Required?	Type	Default value	Description
imo	yes	integer		The International Maritime Organization (IMO) number of the vessel you wish to import the passage plan for.
file	yes	file		Input file that contains an ECDIS passage plan. Accepted formats are: CSV, RTZ and RT3.
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)

Notes

Ensure your client or library is configured to handle redirects
Passage plans can only be imported for vessels that belong to user's managed vessels (see Fleet Operations solution for more info)

Typical API call:
https://services.marinetraffic.com/api/import-passage-plan/YOUR-API-KEY/

Example API call:
https://services.marinetraffic.com/api/import-passage-plan/8205c862d0572op1655989d939f1496c092ksvs4

Request Body

Key	Value
imo	9750701
file	your_file.rtz
protocol	jsono

XML sample response

<RESPONSE>
     <STATUS>
         <SUCCESS>CODE="s8" DESCRIPTION="PASSAGE PLAN IMPORTED"/>
     </STATUS>
</RESPONSE>

JSON object sample response


{
    "success": [
        {
            "code": "s8",
            "detail": "PASSAGE PLAN IMPORTED"
        }
    ]
}

Response

Field Name	Data Type	Description
CODE	text	Code Status
DESCRIPTION	text	Code Description

Description: Berth Calls

Endpoint URL: https://services.marinetraffic.com/api/berth-calls/v:2

Parameters

Parameter name	Required?	Type	Default value	Description
[no name]	yes	text		API key: 40-character hexadecimal number
timespan	no	integer	2	The maximum age, in minutes, of the returned port calls. Maximum value is 2880.
fromdate		datetime		Berth calls between fromdate and todate. Maximum period requested 15 days. Date format: YYYY-MM-DD HH:MM:SS.
todate		datetime
msgtype	no	text	simple	If used with the value extended, the response includes voyage related data since the previous port call.
protocol	no	text	xml	Response type. Use one of the following: xml, csv, json, jsono (object)
portid	yes (only use one of all)	integer		The MarineTraffic ID of the port you wish to monitor (found on the URL of the respective Port page).
port_unlocode		text		Port UN LOCODE (without gaps or spaces).
berthid		integer		The MarineTraffic ID of the berth you wish to monitor (list to be provided upon request).
terminalid		integer		The MarineTraffic ID of the terminal you wish to monitor (list to be provided upon request).
shipid		integer		The MarineTraffic ID of the vessel you wish to monitor found on the URL of the respective Vessel page.
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.
market	no	text		Define market for which you would like to receive berth calls. 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	no	text		Define ship class for which you would like to receive berth calls.
dwt_min	no (use together)	integer		Data filter: minimum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype = 7, 8)
dwt_max	no (use together)	integer		Data filter: maximum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype = 7, 8)
gt_min	no (use together)	integer		Data filter: minimum GT applicable to IMO-having vessels
gt_max	no (use together)	integer		Data filter: maximum GT applicable to IMO-having vessels
movetype	no	integer	1	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 v:2

Notes

Ensure your client or library is configured to handle redirects
Information about AIS-transmitted data

Typical API call:
https://services.marinetraffic.com/api/berth-calls/YOUR-API-KEY/portid:value/timespan:#minutes

Example API call:
https://services.marinetraffic.com/api/berth-calls/bb6e6261b44aa8bcd8246928b11a8f02e8a2e805/portid:1/dwt_min:2000/dwt_max:70000/timespan:20

XML sample response [simple]

<BERTHCALLS>
<BERTHCALL SHIP_ID="414650" MMSI="354530000" IMO="9349813" DOCK_TIMESTAMP_LT="2018-03-13 13:50:00" DOCK_TIMESTAMP_UTC="2018-03-13 11:50:00" DOCK_TIMESTAMP_OFFSET="2.000000" UNDOCK_TIMESTAMP_LT="" UNDOCK_TIMESTAMP_UTC="" UNDOCK_TIMESTAMP_OFFSET="" SHIPNAME="MSC CARMEN" TYPE_NAME="Container Ship" DWT="63359" GRT="50963" FLAG="PA" YEAR_BUILT="2008" BERTH_ID="6" BERTH_NAME="Container Terminal" TERMINAL_ID="978" TERMINAL_NAME="Container Terminal" PORT_ID="1" PORT_NAME="PIRAEUS" UNLOCODE="GRPIR" COUNTRY_CODE="GR" DESTINATION_ID="32" DESTINATION="PAROS" />
<BERTHCALL SHIP_ID="213454" MMSI="240666000" IMO="7427154" DOCK_TIMESTAMP_LT="2018-03-13 14:46:00" DOCK_TIMESTAMP_UTC="2018-03-13 12:46:00" DOCK_TIMESTAMP_OFFSET="2.000000" UNDOCK_TIMESTAMP_LT="" UNDOCK_TIMESTAMP_UTC="" UNDOCK_TIMESTAMP_OFFSET="" SHIPNAME="ADRIANA" TYPE_NAME="Inland, Unknown" DWT="3560" GRT="2234" FLAG="GR" YEAR_BUILT="1976" BERTH_ID="6" BERTH_NAME="Container Terminal" TERMINAL_ID="978" TERMINAL_NAME="Container Terminal" PORT_ID="1" PORT_NAME="PIRAEUS" UNLOCODE="GRPIR" COUNTRY_CODE="GR" DESTINATION_ID="32" DESTINATION="PAROS" />
</BERTHCALLS>

XML sample response [extended]

<BERTHCALLS>
<BERTHCALL SHIP_ID="414650" MMSI="354530000" IMO="9349813" DOCK_TIMESTAMP_LT="2018-03-13 13:50:00" DOCK_TIMESTAMP_UTC="2018-03-13 11:50:00" DOCK_TIMESTAMP_OFFSET="2.000000" UNDOCK_TIMESTAMP_LT="" UNDOCK_TIMESTAMP_UTC="" UNDOCK_TIMESTAMP_OFFSET="" SHIPNAME="MSC CARMEN" TYPE_NAME="Container Ship" DWT="63359" GRT="50963" FLAG="PA" YEAR_BUILT="2008" BERTH_ID="6" BERTH_NAME="Container Terminal" TERMINAL_ID="978" TERMINAL_NAME="Container Terminal" PORT_ID="1" PORT_NAME="PIRAEUS" UNLOCODE="GRPIR" COUNTRY_CODE="GR" DESTINATION_ID="32" DESTINATION="PAROS" ARR_TIMESTAMP_LT="2018-03-13 13:43:00" ARR_TIMESTAMP_UTC="2018-03-13 11:43:00" ARR_DRAUGHT="130" ARR_LOAD_STATUS="3" DISTANCE_TRAVELLED="2931" VOYAGE_SPEED_AVG="188" VOYAGE_SPEED_MAX="226" VOYAGE_IDLE_TIME_MINS="7" PREVIOUS_NOANCH_ID="117" PREVIOUS_NOANCH_TIMESTAMP="2018-03-07 05:36:00" PREVIOUS_NOANCH_NAME="ANTWERP" ELAPSED_NOANCH="9007" DEP_TIMESTAMP_LT="" DEP_TIMESTAMP_UTC="" DEP_DRAUGHT="" DEP_LOAD_STATUS="" PORT_OPERATION="" TIME_AT_BERTH="" TIME_AT_PORT=""/>
<BERTHCALL SHIP_ID="213454" MMSI="240666000" IMO="7427154" DOCK_TIMESTAMP_LT="2018-03-13 14:46:00" DOCK_TIMESTAMP_UTC="2018-03-13 12:46:00" DOCK_TIMESTAMP_OFFSET="2.000000" UNDOCK_TIMESTAMP_LT="" UNDOCK_TIMESTAMP_UTC="" UNDOCK_TIMESTAMP_OFFSET="" SHIPNAME="ADRIANA" TYPE_NAME="Inland, Unknown" DWT="3560" GRT="2234" FLAG="GR" YEAR_BUILT="1976" BERTH_ID="6" BERTH_NAME="Container Terminal" TERMINAL_ID="978" TERMINAL_NAME="Container Terminal" PORT_ID="1" PORT_NAME="PIRAEUS" UNLOCODE="GRPIR" COUNTRY_CODE="GR" DESTINATION_ID="32" DESTINATION="PAROS" ARR_TIMESTAMP_LT="2018-03-12 21:42:00" ARR_TIMESTAMP_UTC="2018-03-12 19:42:00" ARR_DRAUGHT="78" ARR_LOAD_STATUS="3" DISTANCE_TRAVELLED="13" VOYAGE_SPEED_AVG="82" VOYAGE_SPEED_MAX="93" VOYAGE_IDLE_TIME_MINS="310" PREVIOUS_NOANCH_ID="3" PREVIOUS_NOANCH_TIMESTAMP="2018-03-11 14:57:00" PREVIOUS_NOANCH_NAME="PERAMA" ELAPSED_NOANCH="1725" DEP_TIMESTAMP_LT="" DEP_TIMESTAMP_UTC="" DEP_DRAUGHT="" DEP_LOAD_STATUS="" PORT_OPERATION="" TIME_AT_BERTH="" TIME_AT_PORT=""/>
</BERTHCALLS>

CSV sample response [simple]

SHIP_ID, MMSI, IMO, DOCK_TIMESTAMP_LT, DOCK_TIMESTAMP_UTC, DOCK_TIMESTAMP_OFFSET, UNDOCK_TIMESTAMP_LT, UNDOCK_TIMESTAMP_UTC, UNDOCK_TIMESTAMP_OFFSET, SHIPNAME, TYPE_NAME, DWT, GRT, FLAG, YEAR_BUILT, BERTH_ID, BERTH_NAME, TERMINAL_ID, TERMINAL_NAME, PORT_ID, PORT_NAME, UNLOCODE, CO