Vessel Photo
Retrieve the most popular photo of a vessel. 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
| vessel_id required | integer The Maritime Mobile Service Identity (MMSI) or the IMO number of the vessel You can instead use shipid |
| shipid | integer A uniquely assigned ID by MarineTraffic for the subject vessel |
| protocol | string Default: "xml" Response type. Use one of the following:
|
Responses
Response samples
- 200
- 400
- 429
Vessel Particulars
Retrieve particulars for one or more vessels. Notes
- Information about AIS-transmitted data
- If page parameter is missing, then default page:1 will be used instead
- The results returned from the API call are split into pages of 100 rows
- In order to get each page generated by the call, add the /page:#value/ parameter to the URL. The default value is /page:1/
- The API does not return results for vessels that are not IMO-registered
- The API does not return results for dead vessels
- 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 Default: 1 Version of the service to be executed. Use version 5 to get the latest |
| mmsi required | integer The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track (single or comma separated values) You can instead use imo or shipid |
| imo | integer The International Maritime Organization (IMO) number of the vessel you wish to track (single or comma separated values) |
| shipid | integer A uniquely assigned ID by MarineTraffic for the subject vessel (single or comma separated values) |
| timespan | integer The timespan parameter defines the period of time, during which we want to receive the change in a vessel's details The maximum value can be either 5 when the interval parameter is set to days or 2880 when the interval is set to minutes |
| interval | string Default: "minutes" The interval parameter can be either minutes or days |
| protocol | string Default: "xml" Response type. Use one of the following:
|
| page | integer Default: 1 Page number of the results to be returned |
| msgtype | string Default: "simple" Resolution of the response. Available values:
|
Responses
Response samples
- 200
- 400
- 429
[- {
- "MMSI": "440389000",
- "IMO": "9360283",
- "ENI": null,
- "NAME": "DONGJIN AUBE",
- "BUILDER": "HAKATA SHIPBUILDING",
- "PLACE_OF_BUILD": "MATSUYAMA JAPAN",
- "BUILD": "2005",
- "YARD_NUMBER": "HN. 670",
- "BREADTH_EXTREME": "25",
- "BREADTH_MOULDED": "25",
- "DEPTH": "13.7",
- "SUMMER_DWT": "15220",
- "DISPLACEMENT_SUMMER": null,
- "CALLSIGN": "D7OT",
- "FLAG": "KR",
- "DRAUGHT": "8.97",
- "LENGTH_OVERALL": "147",
- "LENGTH_B_W_PERPENDICULARS": "135",
- "FUEL_CONSUMPTION": "36 t/day at 17.50 kn",
- "SPEED_MAX": null,
- "SPEED_SERVICE": "18",
- "TEU": "1060",
- "GROSS_TONNAGE": "12679",
- "NET_TONNAGE": "5614",
- "LIQUID_OIL": null,
- "LIQUID_GAS": null,
- "GRAIN": null,
- "OWNER": "DONG JIN SHIPPING CO LTD",
- "MANAGER": "DONG JIN SHIPPING CO LTD",
- "FINANCIAL_OWNER": "DONG JIN SHIPPING CO LTD",
- "TECHNICAL_MANAGER": null,
- "INSURER": "JAPAN SHIP OWNERS P & I ASSOCIATION",
- "VESSEL_TYPE": "CONTAINER SHIP"
}
]