Search Vessel

Search Vessel by Idenitifier

Search for a vessel by unique identifier.

Notes

API Rate Limit is 100 requests per minute

path Parameters

api_key

required

string

API key: 40-character hexadecimal number

query Parameters

shipid required	integer A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use mmsi or imo
mmsi	integer The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track NOTE: Using MMSI may potentially return multiple records as multiple vessels might have transponded the same MMSI
imo	integer The International Maritime Organization (IMO) number of the vessel you wish to track NOTE: Using IMO may potentially return multiple records as multiple vessels might have transponded the same IMO
shiptype	integer Filter data by vessel type: 2: Fishing 4: High Speed Craf 6: Passenger 7: Cargo 8: Tanker
type_name_id	integer Data filter: AIS Shiptype Find more information here
protocol	string Default: "xml" Response type. Use one of the following: xml csv json jsono

Responses

Response samples

200
400
429

Content type

[{"SHIPNAME": "THE QUEEN JACQUELINE",
"MMSI": "244740452",
"IMO": "0",
"SHIP_ID": "639",
"CALLSIGN": "PE6545",
"TYPE_NAME": "Inland, Ferry",
"DWT": "",
"FLAG": "NL",
"COUNTRY": "Netherlands",
"YEAR_BUILT": "",
"MT_URL": "http://www.marinetraffic.com/en/ais/details/ships/shipid:639/mmsi:244740452/vessel:639"
},
{"SHIPNAME": "BACHATA QUEEN",
"MMSI": "229540000",
"IMO": "0",
"SHIP_ID": "2771",
"CALLSIGN": "9HB3419",
"TYPE_NAME": "Pleasure Craft",
"DWT": "",
"FLAG": "MT",
"COUNTRY": "Malta",
"YEAR_BUILT": "",
"MT_URL": "http://www.marinetraffic.com/en/ais/details/ships/shipid:2771/mmsi:229540000/vessel:2771"
}
]

Search Vessel by Name

Search for vessels by vessel name.

Notes
In case of multiple results:

the first 100 matches will be fetched
exact matches are always first on the returned list

Only active vessels are returned
API Rate Limit is 100 requests per minute

path Parameters

api_key

required

string

API key: 40-character hexadecimal number

query Parameters

shipname required	string The vessel name. The results will contain all vessels whose name is like the given words
shiptype	integer Filter data by vessel type: 2: Fishing 4: High Speed Craf 6: Passenger 7: Cargo 8: Tanker
type_name_id	integer Data filter: AIS Shiptype Find more information here
protocol	string Default: "xml" Response type. Use one of the following: xml csv json jsono

Responses

Response samples

200
400
429

Content type

[{"SHIPNAME": "THE QUEEN JACQUELINE",
"MMSI": "244740452",
"IMO": "0",
"SHIP_ID": "639",
"CALLSIGN": "PE6545",
"TYPE_NAME": "Inland, Ferry",
"DWT": "",
"FLAG": "NL",
"COUNTRY": "Netherlands",
"YEAR_BUILT": "",
"MT_URL": "http://www.marinetraffic.com/en/ais/details/ships/shipid:639/mmsi:244740452/vessel:639"
},
{"SHIPNAME": "BACHATA QUEEN",
"MMSI": "229540000",
"IMO": "0",
"SHIP_ID": "2771",
"CALLSIGN": "9HB3419",
"TYPE_NAME": "Pleasure Craft",
"DWT": "",
"FLAG": "MT",
"COUNTRY": "Malta",
"YEAR_BUILT": "",
"MT_URL": "http://www.marinetraffic.com/en/ais/details/ships/shipid:2771/mmsi:229540000/vessel:2771"
}
]