Latest Vessel Positions

(PS02) Vessel Positions of a Static Fleet

Keep a close eye on the vessel or group of vessels of your interest.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

timespan
integer
Default: 5

The maximum age, in minutes, of the returned positions.

Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180

shiptype
integer

Filter data by vessel type:

  • 2: Fishing
  • 4: High Speed Craf
  • 6: Passenger
  • 7: Cargo
  • 8: Tanker
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
  • full
If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

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

(PS03) Vessel Positions of a Dynamic Fleet

Monitor vessel activity for your MarineTraffic fleet(s).

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

timespan
integer
Default: 5

The maximum age, in minutes, of the returned positions

Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180

shiptype
integer

Filter data by vessel type:

  • 2: Fishing
  • 4: High Speed Craf
  • 6: Passenger
  • 7: Cargo
  • 8: Tanker
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
  • full
If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

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

(PS04) Vessel Positions within a Port

Monitor vessel activity in one or more ports of your interest.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

timespan
integer
Default: 5

The maximum age, in minutes, of the returned positions

Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180

shiptype
integer

Filter data by vessel type:

  • 2: Fishing
  • 4: High Speed Craf
  • 6: Passenger
  • 7: Cargo
  • 8: Tanker
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
  • full
If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

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

(PS05) Vessel Positions in a Predefined Bounding Box

Monitor vessel activity in an area of your interest.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

timespan
integer
Default: 5

The maximum age, in minutes, of the returned positions

Maximum value for terrestrial coverage is 60. Maximum value for satellite coverage is 180

shiptype
integer

Filter data by vessel type:

  • 2: Fishing
  • 4: High Speed Craf
  • 6: Passenger
  • 7: Cargo
  • 8: Tanker
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
  • full
If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

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

(PS06) Vessel Positions in a Dynamic Bounding Box

Retrieve positions for vessels sailing in an area that you define each time you call the service.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

timespan
integer
Default: 5

The maximum age, in minutes, of the returned positions. Maximum value is 2880

shiptype
integer

Filter data by vessel type:

  • 2: Fishing
  • 4: High Speed Craf
  • 6: Passenger
  • 7: Cargo
  • 8: Tanker
MAXLAT
required
number

Use with MINLAT, MINLON, MAXLON to define an area and retrieve positional information of vessels sailing in it

MINLON
required
number

Use with MINLAT, MAXLAT, MAXLON to define an area and retrieve positional information of vessels sailing in it

MAXLON
required
number

Use with MINLAT, MINLON, MAXLAT to define an area and retrieve positional information of vessels sailing in it

MINLAT
required
number

Use with MAXLAT, MINLON, MAXLON to define an area and retrieve positional information of vessels sailing in it

protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono
msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
  • full
If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)

Responses

Response samples

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

(PS07) Single Vessel Positions

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

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

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: 2

The maximum age, in minutes, of the returned positions. Maximum value is 2880

msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
If used with the value extended, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    }
]

(PS08) Vessel Positions in a Custom Area

Monitor vessel activity in a Custom Area of your interest.

Notes

  • Information about AIS-transmitted data
  • SPEED returned in (knots x10) and TIMESTAMP in UTC
  • HEADING for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
  • HEADING values -1 or 511 indicate lack of data
  • SPEED and COURSE values for base stations are represented by zero (0)
  • More information about response parameters: STATUS, SHIPTYPE
path Parameters
api_key
required
string

API key: 40-character hexadecimal number

query Parameters
v
required
integer
Default: 1

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

timespan
integer
Default: 5

The maximum age, in minutes, of the returned positions. Maximum value is 2880

shiptype_generic
integer

Filter vessels based on generic vessel types, comma separated values supported

Vessel type ID should be used and not vessel type name (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)

Should not be combined with shiptype_detailed filter

shiptype_detailed
integer

Filter vessels based on detailed vessel types, comma separated values supported

Vessel type ID should be used and not vessel type name - more

Should not be combined with shiptype_generic filter

msgtype
string
Default: "simple"

Resolution of the response. Available values:

  • simple
  • extended
  • full
If used with the value extended or full, the response includes scheduled static and voyage related vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service terms)

If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)
protocol
string
Default: "xml"

Response type. Use one of the following:

  • xml
  • csv
  • json
  • jsono

Responses

Response samples

Content type
Example
[
  • {
    },
  • {
    }
]
➔ Next to Single Vessel Events