VesselsList

Description

VESSELSLIST method allows you to query any combination of AIS data, Voyage or Master data for a fleet of predefined vessels by IMO/MMSI in JSON or XML format.

This service is available on subscription basis for a fixed fee. The fee depends on the fleet size and requested datasets. VESSELSLIST works with a fixed fleet of vessels and it is more cost-effective compared to the 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

URL format

https://api.vesselfinder.com/vesselslist?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
interval no integer unlimited The maximum age of the returned positions (in minutes)

Examples (JSON format)

https://api.vesselfinder.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":"",
            "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",
            "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",
            "ETA_AIS":"08-11 04:00",
            "ETA":"2017-08-11 04:00:00 UTC",
            "SRC":"TER"
            "ZONE": "North Sea",
            "ECA": true                             
        }
    }
]

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

Examples (XML format)

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