MarineTraffic logo

MarineTraffic AIS

Vessel Positions

Track vessels of interest anywhere in the world.

Notes

  • Information about AIS-transmitted data
  • SPEED speed over ground returned in (knots x10)
  • SPEED and COURSE values for base stations are represented by zero (0)
  • TIMESTAMP UTC second when the report was generated (0-59)
  • HEADING true heading in degrees (0-359) (values -1 or 511 indicate lack of data)
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • DSRC describes whether the transmitted AIS message was received by a terrestrial (TER), satellite (SAT) or roaming (ROAM) AIS antenna.
  • The timespan parameter lets you specify how far back in time the API should look for the latest available vessel positions. Default value is set to 5 minutes and can be adjusted to a maximum of 1,440 minutes (24 hours).
  • More information about response parameters: STATUS, SHIPTYPE
  • 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
required
integer

Use latest version 9

timespan
integer
Default: 5

Overrides the default timespan

vesseltypeid
integer

Filter vessels based on vessel types, comma separated ids supported

more

cursor
string

The pagination cursor provided in the metadata section of the previous response

limit
integer
Default: 2000

The limit of vessels per page (min=1000, max=5000)

protocol
string
Default: "jsono"

Response type. Use one of the following:

  • jsono
  • csv

Responses

Response samples

Content type
application/json
{
  • "DATA": [
    ],
  • "METADATA": {
    }
}

Vessel Positions in an Area of Interest

Track Vessels of interest in a predefined area of interest.

Notes

  • Information about AIS-transmitted data
  • SPEED speed over ground returned in (knots x10)
  • SPEED and COURSE values for base stations are represented by zero (0)
  • TIMESTAMP UTC second when the report was generated (0-59)
  • HEADING true heading in degrees (0-359) (values -1 or 511 indicate lack of data)
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • DSRC describes whether the transmitted AIS message was received by a terrestrial (TER), satellite (SAT) or roaming (ROAM) AIS antenna.
  • The timespan parameter lets you specify how far back in time the API should look for the latest available vessel positions. Default value is set to 5 minutes and can be adjusted to a maximum of 1,440 minutes (24 hours).
  • More information about response parameters: STATUS, SHIPTYPE
  • 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
required
integer

Use latest version 2

timespan
integer
Default: 5

Overrides the default timespan

vesseltypeid
integer

Filter vessels based on vessel types, comma separated ids supported

more

cursor
string

The pagination cursor provided in the metadata section of the previous response

limit
integer
Default: 2000

The limit of vessels per page (min=1000, max=5000)

protocol
string
Default: "jsono"

Response type. Use one of the following:

  • jsono
  • csv

Responses

Response samples

Content type
application/json
{
  • "DATA": [
    ],
  • "METADATA": {
    }
}

Single Vessel Positions

Get the latest available position and voyage information for a single vessel.

Notes

  • Information about AIS-transmitted data
  • SPEED speed over ground returned in (knots x10)
  • SPEED and COURSE values for base stations are represented by zero (0)
  • TIMESTAMP UTC second when the report was generated (0-59)
  • HEADING true heading in degrees (0-359) (values -1 or 511 indicate lack of data)
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • DSRC describes whether the transmitted AIS message was received by a terrestrial (TER), satellite (SAT) or roaming (ROAM) AIS antenna.
  • The timespan parameter lets you specify how far back in time the API should look for the latest available vessel positions. Default value is set to 5 minutes and can be adjusted to a maximum of 1,440 minutes (24 hours).
  • More information about response parameters: STATUS, SHIPTYPE
  • 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
required
integer

Use latest version 6

shipid
required
integer

A uniquely assigned ID by MarineTraffic for the subject vessel

You can instead use imo or mmsi

imo
integer

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

mmsi
integer

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

timespan
integer
Default: 5

Overrides the default timespan

protocol
string
Default: "jsono"

Response type. Use one of the following:

  • jsono
  • csv

Responses

Response samples

Content type
application/json
[
  • {
    }
]
➔ Next to Vessel Historical Track