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 / 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)

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
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

Examples (JSON format)

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"
        }
    }
]

Examples (XML format)

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>