MarineTraffic logo

Vessel Historical Track

Single Vessel Historical Positions

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

Notes

  • Default resolution for returned positions is up to 2 minutes. Use "period" parameter to limit the frequency of positions
  • Weather data is returned once within each hour's results
  • Information about AIS-transmitted data
  • SPEED speed over ground returned in (knots x10)
  • TIMESTAMP UTC second when the report was generated (0-59)
  • Hourly and daily records are the first records received during the hour or the day respectively
  • 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
  • The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
    Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
integer
Default: 1

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
application/json
application/json
application/xml
Example
Simple
Simple
Extended
[
  • {
    },
  • {
    }
]

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

  • Default resolution for returned positions is up to 2 minutes. Use "period" parameter to limit the frequency of positions
  • Weather data is returned once within each hour's results
  • Information about AIS-transmitted data
  • SPEED speed over ground returned in (knots x10)
  • TIMESTAMP UTC second when the report was generated (0-59)
  • Hourly and daily records are the first records received during the hour or the day respectively
  • 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
  • The frequency of allowed API calls is specific to your API key and is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.
    Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and unsuccessful) requests per minute to ensure system stability.

path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
integer
Default: 1

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
application/json
application/json
application/xml
Example
Simple
Simple
Extended
[
  • {
    },
  • {
    }
]
➔ Next to Vessel Positions (Legacy API)