LiveData

Description

LIVEDATA method allows you to query any combination of AIS data, Voyage or Master data for all vessels in a predefined rectangular geographic area. Additional filters by type, size etc. may be applied.

This service is available on subscription basis for a fixed fee. The fee depends on the area size, vessel traffic density and requested datasets.

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/livedata?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/livedata?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 East Atlantic Ocean",
            "ECA": false            
        }
    },
    {  
        "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",
            "SRC":"TER",
            "ZONE": "North Sea",
            "ECA": true      
        }
    }
]

https://api.vesselfinder.com/livedata?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",
            "SRC":"TER",
            "ZONE": "North Sea",
            "ECA": true      
        },
        "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/livedata?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 Pacific Ocean" ECA="false"/>
  </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="North Pacific Ocean" ECA="false"/>
  </VESSEL>
</VESSELS>