MyShipTracking API

  • VSL03 - Vessel Events

Service Info

Version 1

Description

Get informed about Vessel Events such as Start moving, Stop moving, Destination and ETA changes, AIS updates, Navigational Status changes and more

Endpoint URL

https://api.myshiptracking.com/vesselevents/v:1

Parameters

Parameter Required Type Default value Description
apikey yes text Your 42-character personal API key
resp no text simple simple: Response includes Basic information.
extended: Response includes extra fields as discribe in the next section.
src no text ter ter: Return records captured by terrestrial ais only.
sat: Return records captured by terrestrial-ais and satellite-ais.
days yes (use days or fromdate-todate) int The number of days, starting from the time of request and going backwards.
Max value is 90 (days)
fromdate datetime Date format: YYYY-MM-DD HH:MM
The range between fromdate and todate must be 90 days max
todate datetime
mmsi yes (only use one option) int MMSI number
imo int IMO number
events no text The events you want to include in the response. Leave this parameter empty to get everything available. Use "," in order to set multiple events eg 1,4,5
  • 1 - Port Arrival
  • 2 - Port Departure
  • 3 - In Coverage
  • 4 - Out of Coverage
  • 5 - Start Moving
  • 6 - Stop Moving
  • 8 - Change Sea area
  • 9 - Detected at Sea (If vessel was out of coverage before)
  • 10 - Destination Changed
  • 11 - Draught Changed
  • 12 - ETA Changed
  • 13 - Status Changed
format no text xml Response type. Use one of the following: xml, json

Response Fields

Terrestrial-AIS: 2 credit/record
Field Type Description
MMSI int Maritime Mobile Service Identity
IMO int International Maritime Organisation number
TIMESTAMP datetime The date and time (in UTC) that the event was triggered
EVENT_ID int The corresponding event id
EVENT_TITLE text The name of the event
DESCRIPTION text The details of the event
SRC text Source of AIS data that trigger the event - TER: Terrestrial-AIS or SAT: Satellite-AIS

Response Fields - extended

Terrestrial-AIS: 3 credits/record

Including all simple response fields +

Field Type Description
ASSET_ID int Based on the event type this field returns an ID
  • 1 - MyShipTracking Port ID
  • 2 - MyShipTracking Port ID
LAT real Latitude
LNG real Longitude
HEADING real The heading (in degrees)
COURSE real The course (in degrees)
SPEED real The speed (in knots)

Usage Example

https://api.myshiptracking.com/vesselevents/v:1/apikey:YOUR-API-KEY/mmsi:241087000/days:1/ 
<VESSEL>
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:25:12" EVENT_ID="6" EVENT_NAME="STOP MOVING" DESCRIPTION="BLUE STAR DELOS stop moving" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:12:40" EVENT_ID="1" EVENT_NAME="ARRIVAL" DESCRIPTION="BLUE STAR DELOS has arrived at the port of SANTORINI" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:03:03" EVENT_ID="12" EVENT_NAME="ETA CHANGED" DESCRIPTION="BLUE STAR DELOS eta changed to: 12/2/2018 9:25:00 PM" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:02:53" EVENT_ID="10" EVENT_NAME="DESTINATION CHANGED" DESCRIPTION="BLUE STAR DELOS destination changed to: THI-NAX-PAR-PIR" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:22:39" EVENT_ID="2" EVENT_NAME="DEPARTURE" DESCRIPTION="BLUE STAR DELOS has departed from the port of IOS" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:20:03" EVENT_ID="107" EVENT_NAME="CROSSED AREA" DESCRIPTION="BLUE STAR DELOS crossed custom area: Αγια Ειρήνη" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:20:03" EVENT_ID="106" EVENT_NAME="LEFT AREA" DESCRIPTION="BLUE STAR DELOS left custom area: Ιος Ντόκος" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:19:56" EVENT_ID="5" EVENT_NAME="START MOVING" DESCRIPTION="BLUE STAR DELOS start moving" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:12:52" EVENT_ID="6" EVENT_NAME="STOP MOVING" DESCRIPTION="BLUE STAR DELOS stop moving" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:10:58" EVENT_ID="105" EVENT_NAME="ENTERED AREA" DESCRIPTION="BLUE STAR DELOS entered custom area: Ιος Ντόκος" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:10:02" EVENT_ID="107" EVENT_NAME="CROSSED AREA" DESCRIPTION="BLUE STAR DELOS crossed custom area: Αγια Ειρήνη" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:07:02" EVENT_ID="105" EVENT_NAME="ENTERED AREA" DESCRIPTION="BLUE STAR DELOS entered custom area: ios" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:06:26" EVENT_ID="1" EVENT_NAME="ARRIVAL" DESCRIPTION="BLUE STAR DELOS has arrived at the port of IOS" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T11:59:02" EVENT_ID="7" EVENT_NAME="POSITION REPORT" DESCRIPTION="BLUE STAR DELOS position report 36.73478 / 25.22917 Speed: 23.1 knots, Course: 177.2 degrees" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T10:56:42" EVENT_ID="2" EVENT_NAME="DEPARTURE" DESCRIPTION="BLUE STAR DELOS has departed from the port of NAXOS" SRC="TER" />
</VESSEL>
https://api.myshiptracking.com/vesselevents/v:1/apikey:YOUR-API-KEY/mmsi:241087000/days:1/resp:extended 
<VESSEL>
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:25:12" EVENT_ID="6" EVENT_NAME="STOP MOVING" DESCRIPTION="BLUE STAR DELOS stop moving" ASSET_ID="" LAT="36.38714" LNG="25.42905" HEADING="12.0" COURSE="12.0" SPEED="0.2" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:12:40" EVENT_ID="1" EVENT_NAME="ARRIVAL" DESCRIPTION="BLUE STAR DELOS has arrived at the port of SANTORINI" ASSET_ID="32" LAT="36.41789" LNG="25.40871" HEADING="140.0" COURSE="140.0" SPEED="16.0" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:03:03" EVENT_ID="12" EVENT_NAME="ETA CHANGED" DESCRIPTION="BLUE STAR DELOS eta changed to: 12/2/2018 9:25:00 PM" ASSET_ID="" LAT="36.46163" LNG="25.35756" HEADING="158.0" COURSE="158.9" SPEED="24.1" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T13:02:53" EVENT_ID="10" EVENT_NAME="DESTINATION CHANGED" DESCRIPTION="BLUE STAR DELOS destination changed to: THI-NAX-PAR-PIR" ASSET_ID="" LAT="36.46309" LNG="25.35687" HEADING="158.0" COURSE="159.1" SPEED="24.0" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:22:39" EVENT_ID="2" EVENT_NAME="DEPARTURE" DESCRIPTION="BLUE STAR DELOS has departed from the port of IOS" ASSET_ID="28" LAT="36.71275" LNG="25.26067" HEADING="197.0" COURSE="198.7" SPEED="19.3" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:20:03" EVENT_ID="107" EVENT_NAME="CROSSED AREA" DESCRIPTION="BLUE STAR DELOS crossed custom area: Αγια Ειρήνη" ASSET_ID="229" LAT="" LNG="" HEADING="" COURSE="" SPEED="" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:20:03" EVENT_ID="106" EVENT_NAME="LEFT AREA" DESCRIPTION="BLUE STAR DELOS left custom area: Ιος Ντόκος" ASSET_ID="250" LAT="" LNG="" HEADING="" COURSE="" SPEED="" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:19:56" EVENT_ID="5" EVENT_NAME="START MOVING" DESCRIPTION="BLUE STAR DELOS start moving" ASSET_ID="" LAT="36.72330" LNG="25.26879" HEADING="229.0" COURSE="234.1" SPEED="9.6" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:12:52" EVENT_ID="6" EVENT_NAME="STOP MOVING" DESCRIPTION="BLUE STAR DELOS stop moving" ASSET_ID="" LAT="36.72398" LNG="25.27113" HEADING="299.0" COURSE="299.0" SPEED="0.3" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:10:58" EVENT_ID="105" EVENT_NAME="ENTERED AREA" DESCRIPTION="BLUE STAR DELOS entered custom area: Ιος Ντόκος" ASSET_ID="250" LAT="" LNG="" HEADING="" COURSE="" SPEED="" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:10:02" EVENT_ID="107" EVENT_NAME="CROSSED AREA" DESCRIPTION="BLUE STAR DELOS crossed custom area: Αγια Ειρήνη" ASSET_ID="229" LAT="" LNG="" HEADING="" COURSE="" SPEED="" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:07:02" EVENT_ID="105" EVENT_NAME="ENTERED AREA" DESCRIPTION="BLUE STAR DELOS entered custom area: ios" ASSET_ID="228" LAT="" LNG="" HEADING="" COURSE="" SPEED="" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T12:06:26" EVENT_ID="1" EVENT_NAME="ARRIVAL" DESCRIPTION="BLUE STAR DELOS has arrived at the port of IOS" ASSET_ID="28" LAT="36.71474" LNG="25.26189" HEADING="24.0" COURSE="24.7" SPEED="15.8" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T11:59:02" EVENT_ID="7" EVENT_NAME="POSITION REPORT" DESCRIPTION="BLUE STAR DELOS position report 36.73478 / 25.22917 Speed: 23.1 knots, Course: 177.2 degrees" ASSET_ID="" LAT="36.73478" LNG="25.22917" HEADING="175.0" COURSE="177.2" SPEED="23.1" SRC="TER" />
<EVENT MMSI="241087000" IMO="9565039" TIMESTAMP="2018-12-02T10:56:42" EVENT_ID="2" EVENT_NAME="DEPARTURE" DESCRIPTION="BLUE STAR DELOS has departed from the port of NAXOS" ASSET_ID="22" LAT="37.10557" LNG="25.36471" HEADING="275.0" COURSE="272.2" SPEED="14.6" SRC="TER" />
</VESSEL>
2024 © MyShipTracking.com
Contact