Search Vessel by Idenitifier
Search for a vessel by unique identifier. Notes
- 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
| 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:
|
| type_name_id | integer Data filter: AIS Shiptype Find more information here |
| protocol | string Default: "xml" Response type. Use one of the following:
|
Responses
Response samples
- 200
- 400
- 429
[- {
- "SHIPNAME": "THE QUEEN JACQUELINE",
- "MMSI": "244740452",
- "IMO": "0",
- "SHIP_ID": "639",
- "CALLSIGN": "PE6545",
- "TYPE_NAME": "Inland, Ferry",
- "DWT": "",
- "FLAG": "NL",
- "COUNTRY": "Netherlands",
- "YEAR_BUILT": "",
}, - {
- "SHIPNAME": "BACHATA QUEEN",
- "MMSI": "229540000",
- "IMO": "0",
- "SHIP_ID": "2771",
- "CALLSIGN": "9HB3419",
- "TYPE_NAME": "Pleasure Craft",
- "DWT": "",
- "FLAG": "MT",
- "COUNTRY": "Malta",
- "YEAR_BUILT": "",
}
]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
- 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
| 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:
|
| type_name_id | integer Data filter: AIS Shiptype Find more information here |
| protocol | string Default: "xml" Response type. Use one of the following:
|
Responses
Response samples
- 200
- 400
- 429
[- {
- "SHIPNAME": "THE QUEEN JACQUELINE",
- "MMSI": "244740452",
- "IMO": "0",
- "SHIP_ID": "639",
- "CALLSIGN": "PE6545",
- "TYPE_NAME": "Inland, Ferry",
- "DWT": "",
- "FLAG": "NL",
- "COUNTRY": "Netherlands",
- "YEAR_BUILT": "",
}, - {
- "SHIPNAME": "BACHATA QUEEN",
- "MMSI": "229540000",
- "IMO": "0",
- "SHIP_ID": "2771",
- "CALLSIGN": "9HB3419",
- "TYPE_NAME": "Pleasure Craft",
- "DWT": "",
- "FLAG": "MT",
- "COUNTRY": "Malta",
- "YEAR_BUILT": "",
}
]