VESSELS method allows you to query any combination of AIS data and Voyage or Master data for one or more vessels in JSON or XML format.
| Dataset | Content | Credits |
|---|---|---|
| AIS | Coordinates, course, speed, heading, current draught, destination, ETA and static vessel data | 1 / 5* |
| 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 |
(*) The price of AIS dataset depends on the requested data source (Terrestrial / Satellite)
https://api.vtexplorer.com/vessels?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 |
| extradata | no | text | - | Additional datasets voyage, master |
| sat | no | integer | 0 | AIS data source (0-Terrestrial / 1-Satellite*) |
| 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)** |
(*) API always returns the most up-to-date position and charges credits according to the AIS data source type
(**) Requested vessels may be specified by list of IMO or MMSI numbers or both
https://api.vtexplorer.com/vessels?userkey=AABBCCDD&imo=9175717
[
{
"AIS":{
"MMSI":304491000,
"TIMESTAMP":"2017-08-11 11:15:15 UTC",
"LATITUDE":37.20046,
"LONGITUDE":18.5879,
"COURSE":285.6,
"SPEED":14.0,
"HEADING":286,
"IMO":9175717,
"NAME":"MARENO",
"CALLSIGN":"V2BC5",
"TYPE":70,
"A":133,
"B":20,
"C":14,
"D":11,
"DRAUGHT":8.7,
"DESTINATION":"GIOIA TAURO",
"ETA_AIS":"08-12 03:00",
"ETA":"2017-08-12 03:00:00",
"SRC":"TER"
}
}
]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,
"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"
}
},
{
"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,
"IMO":0,
"NAME":"MARIELLA II",
"CALLSIGN":"IZTN",
"TYPE":30,
"A":6,
"B":12,
"C":1,
"D":4,
"DRAUGHT":2.0,
"DESTINATION":"PESCA",
"ETA_AIS":"00-00 24:60",
"ETA":"",
"SRC":"TER"
}
},
{
"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,
"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"
}
}
]https://api.vtexplorer.com/vessels?userkey=AABBCCDD&extradata=voyage,master&sat=1&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,
"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":"SAT"
},
"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/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" 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"/>
</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" 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"/>
</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" 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"/>
</VESSEL>
</VESSELS>https://api.vtexplorer.com/vessels?userkey=AABBCCDD&extradata=voyage,master&format=xml&sat=1&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" 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="SAT"/>
<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>