Vessels

Description

The VESSELS method allows you to request AIS, Voyage, and/or Master data for one or more vessels, with responses available in JSON or XML format.

Dataset Content Credits
AIS Coordinates, course, speed, heading, current draught, destination, ETA and static vessel data 1
Voyage Last port/country and time of departure 1
Master IMO, name, flag, type, year of build, builder, owner / manager, dimensions, maximum draught, gross tonnage, net tonnage, deadweight, TEU, crude capacity 2

URL format

https://api.vtexplorer.com/vessels?userkey=AABBCCDD&param1=value1&param2=value2....

Parameters

Parameter Required Type Default Description
userkey yes text - Your personal API key
format no text json Response format json or xml
extradata no text - Additional datasets voyage, master
interval no integer unlimited The maximum age of the returned positions (in minutes)
imo yes list of integers - List of IMO numbers (comma separated)*
mmsi yes list of integers - List of MMSI numbers (comma separated)*

(*) Vessels can be specified using a list of IMO numbers, MMSI numbers, or a combination of both.

Examples (JSON format)

https://api.vtexplorer.com/vessels?userkey=AABBCCDD&imo=9175717

[  
    {  
        "AIS":{  
            "MMSI":304491000,
            "TIMESTAMP":"2017-08-11 11:15:15 UTC",
            "LATITUDE":40.07288,
            "LONGITUDE":154.48535,
            "COURSE":285.6,
            "SPEED":14.0,
            "HEADING":286,
            "NAVSTAT":0,
            "IMO":9175717,
            "NAME":"MARENO",
            "CALLSIGN":"V2BC5",
            "TYPE":70,
            "A":133,
            "B":20,
            "C":14,
            "D":11,
            "DRAUGHT":8.7,
            "DESTINATION":"GIOIA TAURO",
            "LOCODE": "ITGIT",
            "ETA_AIS":"08-12 03:00",
            "ETA":"2017-08-12 03:00:00",
            "SRC":"TER",
            "ZONE": "North Pacific Ocean",
            "ECA": false,
        }
    }
]

https://api.vtexplorer.com/vessels?userkey=AABBCCDD&imo=9228801,9441271&mmsi=227441980

[  
    {  
        "AIS":{  
            "MMSI":227441980,
            "TIMESTAMP":"2017-08-11 11:17:37 UTC",
            "LATITUDE":46.1459,
            "LONGITUDE":-1.16631,
            "COURSE":360.0,
            "SPEED":0.0,
            "HEADING":511,
            "NAVSTAT":1,            
            "IMO":0,
            "NAME":"CLEMENTINE",
            "CALLSIGN":"FJVK",
            "TYPE":60,
            "A":0,
            "B":0,
            "C":0,
            "D":0,
            "DRAUGHT":0.0,
            "DESTINATION":"",
            "LOCODE": null,
            "ETA_AIS":"00-00 00:00",
            "ETA":"",
            "SRC":"TER",
            "ZONE": "North Pacific Ocean",
            "ECA": false,
        }
    },
    {  
        "AIS":{  
            "MMSI":247142520,
            "TIMESTAMP":"2017-08-11 11:09:43 UTC",
            "LATITUDE":37.93858,
            "LONGITUDE":20.33623,
            "COURSE":327.3,
            "SPEED":9.0,
            "HEADING":511,
            "NAVSTAT":0,            
            "IMO":0,
            "NAME":"MARIELLA II",
            "CALLSIGN":"IZTN",
            "TYPE":30,
            "A":6,
            "B":12,
            "C":1,
            "D":4,
            "DRAUGHT":2.0,
            "DESTINATION":"PESCA",
            "LOCODE": null,
            "ETA_AIS":"00-00 24:60",
            "ETA":"",
            "SRC":"TER",
            "ZONE": "North Sea",
            "ECA": true,
        }
    },
    {  
        "AIS":{  
            "MMSI":538003777,
            "TIMESTAMP":"2017-08-11 11:18:05 UTC",
            "LATITUDE":36.28361,
            "LONGITUDE":-3.5416,
            "COURSE":260.0,
            "SPEED":11.2,
            "HEADING":260,
            "NAVSTAT":0,            
            "IMO":9441271,
            "NAME":"M/V CANARY",
            "CALLSIGN":"V7TC3",
            "TYPE":70,
            "A":160,
            "B":30,
            "C":10,
            "D":22,
            "DRAUGHT":12.3,
            "DESTINATION":"GIBRALTAR",
            "LOCODE": "GIGIB",
            "ETA_AIS":"08-11 04:00",
            "ETA":"2017-08-11 04:00:00",
            "SRC":"TER",
            "ZONE": "Black Sea",
            "ECA": false,
        }
    }
]

https://api.vtexplorer.com/vessels?userkey=AABBCCDD&extradata=voyage,master&imo=9607198

[  
    {  
        "AIS":{  
            "MMSI":566554000,
            "TIMESTAMP":"2017-08-11 11:43:42 UTC",
            "LATITUDE":54.29732,
            "LONGITUDE":4.75682,
            "COURSE":7.8,
            "SPEED":11.5,
            "HEADING":5,
            "IMO":9607198,
            "NAVSTAT":0,            
            "NAME":"BW HAWK",
            "CALLSIGN":"9V2920",
            "TYPE":80,
            "A":150,
            "B":33,
            "C":9,
            "D":23,
            "DRAUGHT":9.2,
            "DESTINATION":"FRURO>NOMLK",
            "LOCODE":"NOMLK"
            "ETA_AIS":"08-17 00:01",
            "ETA":"2017-08-17 00:01:00",
            "SRC":"TER",
            "ZONE": "Black Sea",
            "ECA": false
        },
        "MASTERDATA":{  
            "IMO":9607198,
            "NAME":"BW HAWK",
            "FLAG":"SG",
            "TYPE":"Chemical/Oil Products Tanker",
            "BUILT":2015,
            "BUILDER":"SPP SB CO",
            "OWNER":"BW CLEARWATER PTE LTD",
            "MANAGER":"BW MARITIME PTE LTD",
            "LENGTH":183.0,
            "BEAM":32.2,
            "MAXDRAUGHT":0.0,
            "GT":29768,
            "NT":0,
            "DWT":49999,
            "TEU":0,
            "CRUDE":0
        },
        "VOYAGE":{  
            "LOCODE":"FRPET",
            "DEPARTURE":"2017-08-09 17:26:38 UTC",
            "LASTPORT":"Petit-Couronne",
            "LASTCOUNTRY":"France"
        }
    }
]

Examples (XML format)

https://api.vtexplorer.com/vessels?userkey=AABBCCDD&format=xml&imo=9228801,9441271&mmsi=227441980

<VESSELS>
  <VESSEL>
    <AIS MMSI="215096000" TIMESTAMP="2017-08-11 11:14:03 UTC" LATITUDE="42.82085" LONGITUDE="9.98676" COURSE="357.0" SPEED="11.2" HEADING="8" NAVSTAT="0" IMO="9228801" NAME="BALTIC SKY I" CALLSIGN="9HCD7" TYPE="89" A="152" B="30" C="7" D="20" DRAUGHT="10.7" DESTINATION="GENOA" ETA_AIS="08-12 08:00" ETA="2017-08-12 08:00:00" SRC="TER" ZONE="North Pacific Ocean" ECA="false"/>
  </VESSEL>
  <VESSEL>
    <AIS MMSI="227441980" TIMESTAMP="2017-08-11 11:23:37 UTC" LATITUDE="46.1459" LONGITUDE="-1.16629" COURSE="360.0" SPEED="0.0" HEADING="511" NAVSTAT="1" IMO="0" NAME="CLEMENTINE" CALLSIGN="FJVK" TYPE="60" A="0" B="0" C="0" D="0" DRAUGHT="0.0" DESTINATION="" ETA_AIS="00-00 00:00" ETA="" SRC="TER" ZONE="North Sea" ECA="true"/>
  </VESSEL>
  <VESSEL>
    <AIS MMSI="538003777" TIMESTAMP="2017-08-11 11:18:05 UTC" LATITUDE="36.28361" LONGITUDE="-3.5416" COURSE="260.0" SPEED="11.2" HEADING="260" NAVSTAT="0" IMO="9441271" NAME="M/V CANARY" CALLSIGN="V7TC3" TYPE="70" A="160" B="30" C="10" D="22" DRAUGHT="12.3" DESTINATION="GIBRALTAR" ETA_AIS="08-11 04:00" ETA="2017-08-11 04:00:00" SRC="TER" ZONE="Black Sea" ECA="false"/>
  </VESSEL>
</VESSELS>

https://api.vtexplorer.com/vessels?userkey=AABBCCDD&extradata=voyage,master&format=xml&imo=9607198

<VESSELS>
  <VESSEL>
    <AIS MMSI="566554000" TIMESTAMP="2017-08-11 11:43:42 UTC" LATITUDE="54.29732" LONGITUDE="4.75682" COURSE="7.8" SPEED="11.5" HEADING="5" NAVSTAT="0" IMO="9607198" NAME="BW HAWK" CALLSIGN="9V2920" TYPE="80" A="150" B="33" C="9" D="23" DRAUGHT="9.2" DESTINATION="FRURO>NOMLK" ETA_AIS="08-17 00:01" ETA="2017-08-17 00:01:00" SRC="TER" ZONE="North Pacific Ocean" ECA="false"/>
    <MASTERDATA IMO="9607198" NAME="BW HAWK" FLAG="SG" TYPE="Chemical/Oil Products Tanker" BUILT="2015" BUILDER="SPP SB CO" OWNER="BW CLEARWATER PTE LTD" MANAGER="BW MARITIME PTE LTD" LENGTH="183.0" BEAM="32.2" MAXDRAUGHT="0.0" GT="29768" NT="0" DWT="49999" TEU="0" CRUDE="0"/>
    <VOYAGE LOCODE="FRPET" DEPARTURE="2017-08-09 17:26:38 UTC" LASTPORT="Petit-Couronne" LASTCOUNTRY="France"/>
  </VESSEL>
</VESSELS>