Vessel History

Please note: API Access is only available to subscribers of our Corporate plan and is not available to subscribers of our consumer-focused subscription alternatives, such as the Premium or Premium Plus subscriptions. If you or your corporation are interested in a Corporate subscription to gain API access to the data that, Inc. collects, please contact us for a quote.

This API endpoint returns the history of a vessel as defined by its IMO. Optionally, the results can also be filtered by a given departure country by providing that country’s country code (2 letters). The results contain data of all exports that, Inc. has tracked for that vessel since the start of the Corporate Subscription’s validity period.

Endpoint URL:[API Key]/[IMO]/[Country Code]

URL Parameters:

Parameter Description
[API Key] The Unique API Key as indicated on the Account Management page.
[IMO] The IMO of the vessel, for example 9726580.
[Country Code] (Optional) A two-character country code, for example US.

The resulting output is a JSON object containing two JSON objects. The first is vessel, containing details about the vessel requested, and the second is a JSON array named export which contains a number of JSON objects with details about each individual export event. These are sorted oldest to newest.

Response Keys:

JSON Key Name JSON Value Type Nullable? Description string false The current name of the vessel according to the best of our understanding.
vessel.imo integer true The IMO of the vessel.
vessel.mmsi integer true The current MMSI of the vessel.
vessel.callsign string true The current callsign of the vessel.
vessel.flag string false The flag that the vessel is currently sailing under.
vessel.deadweight integer true The deadweight of the vessel.
vessel.gross_tonnage integer true The gross tonnage of the vessel.
vessel.type string false The type of vessel.
vessel.size_class string false The size class of the vessel.
export.[].departed_at datestring false A date string in the format YYYY-MM-DD.
export.[].origin_country string false The full name of the originating country, for example Iran.
export.[].origin_port string true The full name of the originating port, for example Kharg Island.
export.[].destination_country string false The full name of the destination country, for example China.
export.[].destination_port string true The full name of the destination port, for example Qingdao.
export.[].barrels integer false The total number of barrels carried by this vessel during this journey.
export.[].draft float false The draft/draught level of this vessel as observed during this journey.
export.[].cargo_type string false The type of cargo carried by this vessel on this journey.
export.[].notes string true Relevant notes, if any, about this particular journey.

Still need help? Contact us

© 2018-2022, Inc.