The VESSELSLIST method allows you to retrieve any combination of AIS, Voyage, or Master data for a predefined fleet of vessels, identified by IMO or MMSI. Responses are available in JSON or XML format.
This service is offered on a subscription basis, billed quarterly in advance. The fee varies based on fleet size, the datasets selected, and the request frequency. Because it operates with a fixed list of vessels, VESSELSLIST is a more cost-effective option compared to the on-demand VESSELS method.
| Data | Content |
|---|---|
| AIS | Coordinates, course, speed, heading, current draught, destination, ETA and static vessel data |
| Voyage | Last port/country and time of departure |
| Master | IMO, name, flag, type, year of build, builder, owner / manager, dimensions, maximum draught, gross tonnage, net tonnage, deadweight, TEU, crude capacity |
https://api.vtexplorer.com/vesselslist?userkey=AABBCCDD¶m1=value1¶m2=value2....
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| userkey | yes | text | - | Your personal API key |
| format | no | text | json | Response format json or xml |
| interval | no | integer | - | The maximum age of the returned positions (in minutes) |
The predefined vessel list is managed using the ListManager method, which lets you view, add, replace, or remove vessels.
https://api.vtexplorer.com/vesselslist?userkey=AABBCCDD
[
{
"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 Sea",
"ECA": true
}
},
{
"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": "Black Sea",
"ECA": false
}
},
{
"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 UTC",
"SRC":"TER",
"ZONE": "North Sea",
"ECA": true
}
}
]https://api.vtexplorer.com/vesselslist?userkey=AABBCCDD
[
{
"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 UTC",
"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"
}
}
]https://api.vtexplorer.com/vesselslist?userkey=AABBCCDD&format=xml
<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>