Vessel Historical Track

(PS01) Single Vessel Historical Positions

Get all historical positions of a single vessel for a specific period of time.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • Hourly and daily records are the first records received during the hour or the day respectively
  • When the msgtype is extended, only on the first row of each hour the weather-related data fields return values
  • When the period is hourly, the data field HEADING is not available for positions older than 2017-11-17
  • Hourly records are available for dates after 2014-08-28
  • Weather data for winds are available for dates after 2015-05-27
  • Weather data for waves, swells and currents are available for dates after 2021-01-21
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
integer
Default: 3

Version of the service to be executed. Use version 3 to get the latest

shipid
required
integer

A uniquely assigned ID by MarineTraffic for the subject vessel

You can instead use imo or mmsi

mmsi
integer

The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track

imo
integer

The International Maritime Organization (IMO) number of the vessel you wish to track

days
required
integer

The number of days, starting from the time of request and going backwards, for which the response should look for position data

Maximum value is 190 (days)

fromdate
string <date-time>

Use with todate instead of days to get data for a date period

todate
string <date-time>

Use with fromdate instead of days to get data for a date period

period
string

Limit position per vessel. Omit to get all the available positions

Values are:

  • hourly: get one position per hour
  • daily: get one position per day
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
If used with the value extended, the response includes also weather data
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    },
  • {
    }
]

(PS01) Vessel Historical Positions in an Area

Get vessel historical positions for a single or for all vessels inside an area of your preference for a specific period of time.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • Hourly and daily records are the first records received during the hour or the day respectively
  • When the msgtype is extended, only on the first row of each hour the weather-related data fields return values
  • When the period is hourly, the data field HEADING is not available for positions older than 2017-11-17
  • Hourly records are available for dates after 2014-08-28
  • Weather data for winds are available for dates after 2015-05-27
  • Weather data for waves, swells and currents are available for dates after 2021-01-21
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
integer
Default: 3

Version of the service to be executed. Use version 3 to get the latest

days
required
integer

The number of days, starting from the time of request and going backwards, for which the response should look for position data

Maximum value is 190 (days)

fromdate
string <date-time>

Use with todate instead of days to get data for a date period

todate
string <date-time>

Use with fromdate instead of days to get data for a date period

MINLAT
required
number

Use with MAXLAT, MINLON, MAXLON to define an area for which you wish to either get all the historical vessels' positions or historical positions for a specific vessel

The absolute value of MAXLAT - MINLAT + MAXLON - MINLON has to be equal to or less than 2

If you do not define a vessel, the maximum period for which you can look back has a maximum period of one day

MAXLAT
required
number

Use with MINLAT, MINLON, MAXLON to define an area for which you wish to either get all the historical vessels' positions or historical positions for a specific vessel

The absolute value of MAXLAT - MINLAT + MAXLON - MINLON has to be equal to or less than 2

If you do not define a vessel, the maximum period for which you can look back has a maximum period of one day

MINLON
required
number

Use with MINLAT, MAXLAT, MAXLON to define an area for which you wish to either get all the historical vessels' positions or historical positions for a specific vessel

The absolute value of MAXLAT - MINLAT + MAXLON - MINLON has to be equal to or less than 2

If you do not define a vessel, the maximum period for which you can look back has a maximum period of one day

MAXLON
required
number

Use with MINLAT, MAXLAT, MINLON to define an area for which you wish to either get all the historical vessels' positions or historical positions for a specific vessel

The absolute value of MAXLAT - MINLAT + MAXLON - MINLON has to be equal to or less than 2

If you do not define a vessel, the maximum period for which you can look back has a maximum period of one day

shipid
integer

A uniquely assigned ID by MarineTraffic for the subject vessel

You can instead use imo or mmsi

mmsi
integer

The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track

imo
integer

The International Maritime Organization (IMO) number of the vessel you wish to track

period
string

Limit position per vessel. Omit to get all the available positions

Values are:

  • hourly: get one position per hour
  • daily: get one position per day
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
If used with the value extended, the response includes also weather data
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    },
  • {
    }
]
➔ Next to Latest Vessel Positions