VesselFinder AIS API Documentation

AIS Dataset

The AIS Dataset is included in the response of the following methods:

The data is returned in JSON or XML format and includes the following fields:

FieldTypeDescription
MMSIintegerMMSI number of the vessel (AIS identifier)
TIMESTAMPdatetimeDate and time (UTC) when the position was received by AIS, YYYY-MM-DD HH:MM:SS UTC
LATITUDEfloatGeographical latitude (WGS84)
LONGITUDEfloatGeographical longitude (WGS84)
COURSEfloatCourse over ground (degrees)
SPEEDfloatSpeed over ground (knots)
HEADINGintegerHeading (degrees) of the vessel's hull. A value of 511 indicates there is no heading data
NAVSTATintegerNavigation status, see AIS NavStat
IMOintegerIMO number of the vessel, 0 if not available
NAMEtextName of the vessel
CALLSIGNtextCallsign of the vessel
TYPEintegerType of the vessel, see AIS Ship Types
AintegerDistance (meters) from AIS GPS antenna to the bow of the vessel
BintegerDistance (meters) from AIS GPS antenna to the stern of the vessel (Vessel Length = A + B)
CintegerDistance (meters) from AIS GPS antenna to the port side of the vessel
DintegerDistance (meters) from AIS GPS antenna to the starboard side of the vessel (Vessel Width = C + D)
DRAUGHTfloatDraught as reported via AIS
DESTINATIONtextPort of destination (manually entered by the master)
LOCODEtextUN/LOCODE of the port of destination, empty if it cannot be determined
ETA_AIStextEstimated time of arrival at the port of destination (manually entered by the master), MM-DD HH:MM
ETAtextEstimated time of arrival in full date/time format (year is added by the API), YYYY-MM-DD HH:MM:SS
SRCtextSource of AIS data. Always TER (terrestrial)
ZONEtextName of the world zone where the vessel is located
ECAboolIndicates whether the vessel is inside an ECA/SECA zone (true / false)

Example

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