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

200
403

Content type

Example

[{"MMSI": "240389000",
"IMO": "9208679",
"SHIP_ID": "212537",
"LAT": "37.512420",
"LON": "24.913050",
"SPEED": "229",
"HEADING": "294",
"COURSE": "295",
"STATUS": "0",
"TIMESTAMP": "2020-10-13T07:49:57.000Z",
"DSRC": "TER",
"UTC_SECONDS": "55"
},
{"MMSI": "310627000",
"IMO": "9241061",
"SHIP_ID": "371681",
"LAT": "50.510430",
"LON": "-3.453147",
"SPEED": "4",
"HEADING": "276",
"COURSE": "236",
"STATUS": "1",
"TIMESTAMP": "2020-10-13T07:48:16.000Z",
"DSRC": "TER",
"UTC_SECONDS": "16"
}
]

(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

200

Content type

Example

[{"MMSI": "240389000",
"IMO": "9208679",
"SHIP_ID": "212537",
"LAT": "37.515440",
"LON": "24.904090",
"SPEED": "229",
"HEADING": "290",
"COURSE": "292",
"STATUS": "0",
"TIMESTAMP": "2020-10-13T07:51:09.000Z",
"DSRC": "TER",
"UTC_SECONDS": "7"
},
{"MMSI": "241159000",
"IMO": "9565041",
"SHIP_ID": "214617",
"LAT": "37.941010",
"LON": "23.624440",
"SPEED": "1",
"HEADING": "154",
"COURSE": "154",
"STATUS": "0",
"TIMESTAMP": "2020-10-13T07:46:32.000Z",
"DSRC": "TER",
"UTC_SECONDS": "30"
}
]

(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

200

Content type

Example

[{"MMSI": "244830406",
"IMO": "0",
"SHIP_ID": "253535",
"LAT": "52.371040",
"LON": "4.888482",
"SPEED": "0",
"HEADING": "511",
"COURSE": "0",
"STATUS": "5",
"TIMESTAMP": "2020-10-13T07:49:59.000Z",
"DSRC": "TER",
"UTC_SECONDS": "59"
},
{"MMSI": "244780352",
"IMO": "0",
"SHIP_ID": "250936",
"LAT": "52.377110",
"LON": "4.900798",
"SPEED": "2",
"HEADING": "511",
"COURSE": "16",
"STATUS": "7",
"TIMESTAMP": "2020-10-13T07:49:59.000Z",
"DSRC": "TER",
"UTC_SECONDS": "59"
}
]

(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

200

Content type

Example

[{"MMSI": "538003913",
"IMO": "9470959",
"SHIP_ID": "713139",
"LAT": "37.388430",
"LON": "23.871230",
"SPEED": "6",
"HEADING": "104",
"COURSE": "41",
"STATUS": "0",
"TIMESTAMP": "2020-10-15T12:21:44.000Z",
"DSRC": "TER",
"UTC_SECONDS": "45"
},
{"MMSI": "239885200",
"IMO": "0",
"SHIP_ID": "3463456",
"LAT": "37.390210",
"LON": "24.396990",
"SPEED": "1",
"HEADING": "511",
"COURSE": "0",
"STATUS": "99",
"TIMESTAMP": "2020-10-15T12:21:29.000Z",
"DSRC": "TER",
"UTC_SECONDS": "29"
}
]

(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

200

Content type

Example

[{"MMSI": "538006210",
"IMO": "9314105",
"SHIP_ID": "475106",
"LAT": "36.007480",
"LON": "22.291650",
"SPEED": "4",
"HEADING": "273",
"COURSE": "49",
"STATUS": "0",
"TIMESTAMP": "2020-10-15T12:26:10.000Z",
"DSRC": "TER",
"UTC_SECONDS": "7"
},
{"MMSI": "355281000",
"IMO": "9590826",
"SHIP_ID": "416371",
"LAT": "36.008020",
"LON": "22.596420",
"SPEED": "144",
"HEADING": "95",
"COURSE": "94",
"STATUS": "0",
"TIMESTAMP": "2020-10-15T12:26:02.000Z",
"DSRC": "TER",
"UTC_SECONDS": "59"
}
]

(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

200
400

Content type

Example

[{"MMSI": "310627000",
"LAT": "50.510560",
"LON": "-3.452753",
"SPEED": "0",
"HEADING": "347",
"COURSE": "321",
"STATUS": "1",
"TIMESTAMP": "2020-10-13T12:21:16.000Z",
"DSRC": "TER"
}
]

(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

200

Content type

Example

[{"MMSI": "538003913",
"IMO": "9470959",
"SHIP_ID": "713139",
"LAT": "37.388430",
"LON": "23.871230",
"SPEED": "6",
"HEADING": "104",
"COURSE": "41",
"STATUS": "0",
"TIMESTAMP": "2020-10-15T12:21:44.000Z",
"DSRC": "TER",
"UTC_SECONDS": "45"
},
{"MMSI": "239885200",
"IMO": "0",
"SHIP_ID": "3463456",
"LAT": "37.390210",
"LON": "24.396990",
"SPEED": "1",
"HEADING": "511",
"COURSE": "0",
"STATUS": "99",
"TIMESTAMP": "2020-10-15T12:21:29.000Z",
"DSRC": "TER",
"UTC_SECONDS": "29"
}
]