Vessels

Description

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
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.vesselfinder.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)

Note: Requested vessels may be specified by list of IMO or MMSI numbers or both

Examples (JSON format)

https://api.vesselfinder.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"
        }
    }
]

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,
            "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":""
        }
    },
    {  
        "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":""
        }
    },
    {  
        "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"
        }
    }
]

https://api.vesselfinder.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,
            "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"
        },
        "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.vesselfinder.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"/>
  </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=""/>
  </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"/>
  </VESSEL>
</VESSELS>

https://api.vesselfinder.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" 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"/>
    <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>