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.vesselfinder.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.vesselfinder.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,
"DISTANCE_REMAINING": null,
"ETA_PREDICTED": null
}
}
]https://api.vesselfinder.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,
"DISTANCE_REMAINING": null,
"ETA_PREDICTED": null
}
},
{
"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,
"DISTANCE_REMAINING": null,
"ETA_PREDICTED": null
}
},
{
"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,
"DISTANCE_REMAINING": null,
"ETA_PREDICTED": null
}
}
]https://api.vesselfinder.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,
"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":"SAT",
"ZONE": "Black Sea",
"ECA": false,
"DISTANCE_REMAINING": 127,
"ETA_PREDICTED": "2017-08-17 00:03:15 UTC"
},
"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.vesselfinder.com/vessels?userkey=AABBCCDD&format=xml&imo=9228801,9441271&mmsi=227441980
<VESSELS>
<VESSEL>
<AIS MMSI="538003777" TIMESTAMP="2022-02-08 14:45:52 UTC" LATITUDE="36.930946" LONGITUDE="1.014146" COURSE="76.0" SPEED="10.8" HEADING="75" NAVSTAT="15" IMO="9441271" NAME="CANARY" CALLSIGN="V7TC3" TYPE="70" A="160" B="30" C="10" D="22" DRAUGHT="12.6" DESTINATION="TR ISK" LOCODE="TRISK" ETA_AIS="02-14 08:00" ETA="2022-02-14 08:00:00" SRC="TER" ZONE="West Mediterranean" ECA="false" DISTANCE_REMAINING="null" ETA_PREDICTED="null"/>
</VESSEL>
<VESSEL>
<AIS MMSI="636093020" TIMESTAMP="2022-02-08 14:43:03 UTC" LATITUDE="18.6017" LONGITUDE="118.821236" COURSE="219.0" SPEED="13.2" HEADING="219" NAVSTAT="15" IMO="9228801" NAME="BALTIC SKY I" CALLSIGN="9HCD7" TYPE="80" A="153" B="29" C="22" D="5" DRAUGHT="7.5" DESTINATION="KRPUS>IDDUM" LOCODE="IDDUM" ETA_AIS="02-14 03:00" ETA="2022-02-14 03:00:00" SRC="TER" ZONE="China Coast" ECA="false" DISTANCE_REMAINING="null" ETA_PREDICTED="null"/>
</VESSEL>
<VESSEL>
<AIS MMSI="227441980" TIMESTAMP="2022-02-05 09:39:55 UTC" LATITUDE="-0.711736" LONGITUDE="8.785095" COURSE="309.0" SPEED="0.0" HEADING="511" NAVSTAT="0" IMO="0" NAME="CLEMENTINE" CALLSIGN="" TYPE="0" A="0" B="0" C="0" D="0" DRAUGHT="0.0" DESTINATION="" LOCODE="" ETA_AIS="00-00 24:60" ETA="" SRC="TER" ZONE="West Africa" ECA="false" DISTANCE_REMAINING="null" ETA_PREDICTED="null"/>
</VESSEL>
</VESSELS>https://api.vesselfinder.com/vessels?userkey=AABBCCDD&extradata=voyage,master&format=xml&sat=1&imo=9607198
<VESSELS>
<VESSEL>
<AIS MMSI="566554000" TIMESTAMP="2022-02-08 14:48:13 UTC" LATITUDE="13.533056" LONGITUDE="50.025475" COURSE="251.0" SPEED="13.2" HEADING="248" NAVSTAT="15" IMO="9607198" NAME="BW HAWK" CALLSIGN="9V2920" TYPE="80" A="150" B="33" C="9" D="23" DRAUGHT="10.0" DESTINATION="ARMED GUARDS ONBOARD" LOCODE="" ETA_AIS="02-14 16:00" ETA="2022-02-14 16:00:00" SRC="SAT" ZONE="Arabian Sea" ECA="false" DISTANCE_REMAINING="null" ETA_PREDICTED="null"/>
<MASTERDATA IMO="9607198" NAME="BW HAWK" FLAG="SG" TYPE="Chemical/Oil Products Tanker" BUILT="2015" BUILDER="SPP SHIPBUILDING GOSEONG SHIPYARD" OWNER="BW CLEARWATER PTE LTD" MANAGER="HAFNIA PTE LTD" CLASS="AMERICAN BUREAU OF SHIPPING" LENGTH="183.0" BEAM="32.229" MAXDRAUGHT="13.27" GT="29783" NT="13756" DWT="49999" TEU="3600" CRUDE="0"/>
<VOYAGE LOCODE="SGSIN" DEPARTURE="2022-01-28 15:15:26 UTC" LASTPORT="Singapore Anch. 4" LASTCOUNTRY="Singapore"/>
</VESSEL>
</VESSELS>