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: Keep a close eye on the vessel or group of vessels of your interest

Endpoint URL: http://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, 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

  • 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:
http://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
http://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

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

Example API call:
http://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"}]
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 - more
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_NAME text The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT_NAME 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 integer The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED integer 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 - more
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 that the subject vessel is currently at
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
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: Monitor vessel activity for your MarineTraffic fleet(s)

Endpoint URL: http://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, 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

  • 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:
http://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
http://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

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

Example API call:
http://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"}]
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 - more
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_NAME text The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT_NAME 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 integer The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED integer 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 - more
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 that the subject vessel is currently at
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
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: Monitor vessel activity in one or more ports of your interest

Endpoint URL: http://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, 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

  • 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:
http://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
http://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

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

Example API call:
http://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"}]
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 - more
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_NAME text The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT_NAME 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 integer The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED integer 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 - more
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 that the subject vessel is currently at
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
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: Monitor vessel activity in an area of your interest

Endpoint URL: http://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, 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

  • 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:
http://services.marinetraffic.com/api/exportvessels/v:8/YOUR-API-KEY/timespan:#minutes/protocol:value

Example API call:
http://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

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

Example API call:
http://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"}]
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 - more
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_NAME text The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT_NAME 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 integer The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED integer 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 - more
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 that the subject vessel is currently at
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
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: Get the latest available position or voyage information for a particular vessel

Endpoint URL: http://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 two)
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.

Notes

  • 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:
http://services.marinetraffic.com/api/exportvessel/v:5/YOUR-API-KEY/timespan:#minutes/mmsi:value

Example API call:
http://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 - more
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 that the subject vessel is currently at
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: Get the latest arrivals and departures at a specific port or for a vessel

Endpoint URL: http://services.marinetraffic.com/api/portcalls/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.
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 three) 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.
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 datetime  

Notes

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

Example API call:
http://services.marinetraffic.com/api/portcalls/v:2/8205c862d0572op1655989d939f1496c092ksvs4/portid:1/timespan:60

XML sample response [simple]

<PORTCALLS>
<PORTCALL MMSI="566312000" SHIPNAME="MARITIME KELLY ANNE" 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" 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" 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" MOVE_TYPE="1" TYPE_NAME="Container Ship" DRAUGHT="45" INTRANSIT="0"  DISTANCE_TRAVELLED=""  VOYAGE_SPEED_AVG="57"  VOYAGE_SPEED_MAX="73" VOYAGE_IDLE_TIME_MINS="0" ELAPSED_NOANCH="11" PORT_ID="213" PORT_NAME="NEW ORLEANS" UNLOCODE="USMSY" TIMESTAMP_LT="2016-03-03T07:10:00" TIMESTAMP_UTC="2016-03-03T12:10:00"/>
<PORTCALL MMSI="241188000" SHIPNAME="VERNICOS MERMAID" MOVE_TYPE="1" TYPE_NAME="Tug" DRAUGHT="45" INTRANSIT="0" DISTANCE_TRAVELLED="1" VOYAGE_SPEED_AVG="1"  VOYAGE_SPEED_MAX="0" VOYAGE_IDLE_TIME_MINS="0" ELAPSED_NOANCH="46" PORT_ID="50" PORT_NAME="THESSALONIKI" UNLOCODE="GRPIR" TIMESTAMP_LT="2016-03-03T06:42:00" TIMESTAMP_UTC="2016-03-03T12:20:00"/>
<PORTCALL MMSI="215896000" SHIPNAME="BAVARIA" MOVE_TYPE="0" TYPE_NAME="Container Ship" DRAUGHT="84" INTRANSIT="0" DISTANCE_TRAVELLED="206" VOYAGE_SPEED_AVG="119" VOYAGE_SPEED_MAX="145" VOYAGE_IDLE_TIME_MINS="0" ELAPSED_NOANCH="1035" PORT_ID="110" PORT_NAME="BOTANY" UNLOCODE="AUBTB" TIMESTAMP_LT="2016-03-04T00:01:00"  TIMESTAMP_UTC="2016-03-03T13:01:00"/>
</PORTCALLS>

CSV sample response [simple]

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

CSV sample response [extended]

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

Simplified JSON sample response [simple]

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

Simplified JSON sample response [extended]

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

JSON object sample response [simple]

[{"MMSI":"566312000","SHIPNAME":"MARITIME KELLY ANNE","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","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","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"}]

Simplified JSON sample response [extended]

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

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

Description: Get all vessel historical positions for a specific period of time

Endpoint URL: http://services.marinetraffic.com/api/exportvesseltrack/

Parameters

Parameter name Required? Type Default value Description
[no name] yes text   API key: 40-character hexadecimal number
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
todate datetime   Date format: YYYY-MM-DD HH:MM:SS. If absent, current date will be selected.
mmsi yes
(only use one of the two)
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.
MINLAT yes float   Use as a group.
MAXLAT
MINLON
MAXLON
protocol no text xml Response type. Use one of the following: xml, csv, json, jsono (object)

Notes

Typical API call:
http://services.marinetraffic.com/api/exportvesseltrack/YOUR-API-KEY/days:value/mmsi:value

Example API call:
http://services.marinetraffic.com/api/exportvesseltrack/8205c862d0572op1655989d939f1496c092ksvs4/days:3/mmsi:219291000

XML sample response [simple]

<VESSELTRACK>
<POSITION MMSI="219291000" STATUS="0" SPEED="146" LON="-11.904260" LAT="34.485870" COURSE="189" HEADING="190" TIMESTAMP="2013-07-12T10:06:00" SHIP_ID="156750"/>
<POSITION MMSI="219291000" STATUS="0" SPEED="146" LON="-11.901590" LAT="34.498680" COURSE="190" HEADING="191" TIMESTAMP="2013-07-12T10:02:00" SHIP_ID="156750"/>
<POSITION MMSI="219291000" STATUS="0" SPEED="146" LON="-11.895480" LAT="34.526649" COURSE="190" HEADING="191" TIMESTAMP="2013-07-12T09:55:00" SHIP_ID="156750"/>
<POSITION MMSI="219291000" STATUS="0" SPEED="146" LON="-11.893820" LAT="34.534679" COURSE="189" HEADING="191" TIMESTAMP="2013-07-12T09:52:00" SHIP_ID="156750"/>
<POSITION MMSI="219291000" STATUS="0" SPEED="142" LON="-11.883230" LAT="34.588619" COURSE="190" HEADING="191" TIMESTAMP="2013-07-12T09:43:00" SHIP_ID="156750"/>
</VESSELTRACK>

CSV sample response [simple]

MMSI, STATUS, SPEED, LON, LAT, COURSE, HEADING, TIMESTAMP, SHIP_ID
219291000,0,146,-11.904260,34.485870,189,190,2013-07-12T10:06:00,156750
219291000,0,146,-11.901590,34.498680,190,191,2013-07-12T10:02:00,156750
219291000,0,146,-11.895480,34.526649,190,191,2013-07-12T09:55:00,156750
219291000,0,146,-11.893820,34.534679,189,191,2013-07-12T09:52:00,156750
219291000,0,142,-11.883230,34.588619,190,191,2013-07-12T09:43:00,156750

JSON object sample response [simple]

[["219291000","0","146",11.904260",34.485870","189","190","2013-07-12T10:06:00","156750"],
["219291000","0","146",11.901590",34.498680","190","191","2013-07-12T10:02:00","156750"],
["219291000","0","146",11.895480",34.526649","190","191","2013-07-12T09:55:00","156750"],
["219291000","0","146",11.893820",34.534679","189","191","2013-07-12T09:52:00","156750"],
["219291000","0","142",11.883230",34.588619","190","191","2013-07-12T09:43:00","156750"]]

JSON object sample response [simple]

[{"MMSI":"219291000","STATUS":"0","SPEED":"146","LON":"11.904260","LAT":"34.485870","COURSE":"189","HEADING":"190","TIMESTAMP":"2013-07-12T10:06:00","SHIP_ID":"156750"},
{"MMSI":"219291000","STATUS":"0","SPEED":"146","LON":"11.901590","LAT":"34.498680","COURSE":"190","HEADING":"191","TIMESTAMP":"2013-07-12T10:02:00","SHIP_ID":"156750"},
{"MMSI":"219291000","STATUS":"0","SPEED":"146","LON":"11.895480","LAT":"34.526649","COURSE":"190","HEADING":"191","TIMESTAMP":"2013-07-12T09:55:00","SHIP_ID":"156750"},
{"MMSI":"219291000","STATUS":"0","SPEED":"146","LON":"11.893820","LAT":"34.534679","COURSE":"189","HEADING":"191","TIMESTAMP":"2013-07-12T09:52:00","SHIP_ID":"156750"},
{"MMSI":"219291000","STATUS":"0","SPEED":"142","LON":"11.883230","LAT":"34.588619","COURSE":"190","HEADING":"191","TIMESTAMP":"2013-07-12T09:43:00","SHIP_ID":"156750"}]

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
STATUS integer The AIS Navigational Status of the subject vessel - more
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

Description: Retrieve the most popular photo of a vessel

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

Parameters

Parameter name Required? Type Default value Description
[no name] yes text   API key: 40-character hexadecimal number
vessel_id yes integer   The Maritime Mobile Service Identity (MMSI) or the IMO number of the vessel.

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

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

XML sample response

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

Simple response

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

Description: Retrieve positions for vessels sailing in an area that you define each time you call the service

Endpoint URL: http://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, 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

Notes

  • 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:
http://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:
http://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:
http://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:
http://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 - more
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_NAME text The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT_NAME 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 integer The average speed calculated for the subject vessel during the latest voyage (port to port)
MAX_SPEED integer 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 - more
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 that the subject vessel is currently at
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
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: Get vessel particulars

Endpoint URL: http://services.marinetraffic.com/api/vesselmasterdata/v:3

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 two)
integer   The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track (single or comma separated values).
imo integer   The International Maritime Organization (IMO) number of the vessel you wish to track (single or comma separated values).
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

  • 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 500 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/ .

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

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

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

XML sample response

<MASTERDATA TOTAL_RESULTS="1" TOTAL_PAGES="1" CURRENT_PAGE="1">
	<vessel MMSI="304932000" IMO="9375783" NAME="STAPELMOOR" PLACE_OF_BUILD="" BUILD="2006" BREADTH_EXTREME="12.4" SUMMER_DWT="2930" DISPLACEMENT_SUMMER="0" CALLSIGN="V2BU8" FLAG="AG" DRAUGHT="4.36" LENGTH_OVERALL="88.53" FUEL_CONSUMPTION="" SPEED_MAX="0" SPEED_SERVICE="10.5" LIQUID_OIL="0" OWNER="" MANAGER="" MANAGER_OWNER="BOJEN REEDEREI" 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, MANAGER_OWNER, VESSEL_TYPE
304932000,9375783,STAPELMOOR,,2006,12.4,2930,0,V2BU8,AG,4.36,88.53,,0,10.5,0,,,BOJEN REEDEREI,GENERAL CARGO

Simplified JSON sample response

[["304932000","9375783","STAPELMOOR","","2006","12.4","2930","0","V2BU8","AG","4.36","88.53","","0","10.5","0","","","BOJEN REEDEREI","GENERAL CARGO"]]

JSON object sample response [simple]

{"METADATA":{"TOTAL_RESULTS":1,"TOTAL_PAGES":1,"CURRENT_PAGE":1},"DATA":
[{"MMSI":"304932000","IMO":"9375783","NAME":"STAPELMOOR","PLACE_OF_BUILD":"","BUILD":"2006","BREADTH_EXTREME":"12.4","SUMMER_DWT":"2930","DISPLACEMENT_SUMMER":"0","CALLSIGN":"V2BU8","FLAG":"AG","DRAUGHT":"4.36","LENGTH_OVERALL":"88.53","FUEL_CONSUMPTION":"","SPEED_MAX":"0","SPEED_SERVICE":"10.5","LIQUID_OIL":"0","OWNER":"","MANAGER":"","MANAGER_OWNER":"BOJEN REEDEREI","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 (null if the Owner and the Manager are the same)
MANAGER text The Managing Company of the subject vessel (null if the Owner and the Manager are the same)
VESSEL_TYPE text The specific type of the subject vessel
MANAGER_OWNER text The Owning/Managing Company (null if the Owner is different than the Manager)

Description: Search for a vessel

Endpoint URL: https://www.marinetraffic.com/en/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 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.
shipname text The vessel name (you may also find it here)
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

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

Example API call:
http://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="http://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,http://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","http:\/\/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":"http:\/\/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: Get expected arrivals to a specific port or country.

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

Endpoint URL: http://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 the port (or the country’s ports)
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 datetime   Timestamp in the future to stop looking for expected arrivals. Date format: YYYY-MM-DD HH:MM:SS
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 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 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
dwt_max integer   Data filter: maximum DWT

Notes

  • 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:
http://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:
http://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 - more
PORT_UNLOCODE text A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT text The Name of the Port that the subject vessel is currently at
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

Service info

Description:Manage your MarineTraffic fleet

Call requires API Key. Also requires MMSI or IMO 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 which corresponds to the two states of the fleet items (inactive and active)

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

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

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

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

Parameters

Parameter name Required? Type Default value Description
[no name] yes text   API key: 40-character hexadecimal number
mmsi yes integer   The Maritime Mobile Service Identity (MMSI) of the vessel you wish to handle.
imo yes
(if no mmsi has been provided)
integer   The International Maritime Organization (IMO) number of the vessel you wish to handle.
fleet_id no
integer   If used, vessel will be added to the specific fleet, otherwise default fleet is used .
active no integer   Possible values are: 0 to set to inactive, 1 to activate.
delete no integer   Set this parameter to 1 to delete a vessel from your fleet.

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

Example API calls:

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

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

Removes vessel from fleet. http://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: Get a detailed listing of vessels included in one of your MarineTraffic fleets

Endpoint URL: http://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

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

Example API call:
http://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: Get an overview list of all your MarineTraffic fleets

Endpoint URL: http://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)

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

Example API call:
http://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: Get event based intelligence for a vessel

Endpoint URL: http://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 integer 60 The maximum age, in minutes, of the returned events. Maximum value is 2880.
protocol no text xml Response type. Use one of the following: xml, csv, json, jsono (object)
mmsi yes
(only use one of the two)
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.
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

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

Example #1 API call:
http://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:
http://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: Get voyage information for a vessel or for your MarineTraffic Fleet

Endpoint URL: http://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 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.
fleet_id integer   The fleet id you wish to receive voyage forecast for.

Notes

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

Example API call:
http://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
ROUTE text The estimated route of the subject vessel to destination in WKT format

Service info

Description: Check your credits balance

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

Parameters

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

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

Examples API call:
http://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 your MarineTraffic fleet from all vessels

Endpoint URL: http://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.

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

Examples API call:
http://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 A uniquely assigned ID by MarineTraffic for the subject Fleet
DELETE integer Indicates whether the vessels were successfully deleted from a fleet. Possible values: 0