Endpoint: Departing Vessels Per Country Per Month

Please note: This API Endpoint is only available to subscribers of our Corporate plan. If you or your corporation are interested in a Corporate subscription to gain API access to the data that TankerTrackers.com, Inc. collects, please contact us for a quote.


This API endpoint returns a more granular description of exports for a given country during a given month. Instead of grouping the total amount of barrels per destination country, the output is given with details about each individual departure, including details about the vessel, the departure time, and more.

Endpoint URL:

https://tankertrackers.com/api/vm/v4/[API Key]/[Country Code]/[Year]/[Month]

URL Parameters:

Parameter Description
[API Key] The Unique API Key as indicated on the Account Management page.
[Country Code] The two-letter country code for the country, for example EG.
[Year] The four-digit year, for example 2021.
[Month] The number of the month, for example 4 for April.

The resulting output is a JSON array containing one JSON object per journey made by a vessel departing the given country during the given month. This object is broken down into four separate objects; vessel, departure, arrival, and cargo. Note that a vessel may appear more than once in any given month if it made more than one departure during that time.

Response Keys:

In the response, the data object will contain the following keys:

JSON Key Name JSON Value Type Nullable? Description
key string false A unique string identifying this export event.
vessel.name 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.location.latitude float true The latitude of the vessel when we first detected it in connection with this transport event.
vessel.location.longitude float true The longitude of the vessel when we first detected it in connection with this transport event.
vessel.location.timestamp float true The date/time when we first detected it in connection with this transport event.
vessel.evidence string true An URL to an online source that proves the vessel’s location and identity.
departure.timestamp datestring false A date string in the format YYYY-MM-DD.
departure.country string false The full name of the originating country, for example Iran.
departure.country_code string false The ISO 3166-2 name of the originating country, for example IR.
departure.port string true The full name of the originating port, for example Kharg Island.
departure.port.unlocode string true The UNLOCODE of the originating port.
arrival.country string false The full name of the destination country, for example China.
arrival.country_code string false The ISO 3166-2 name of the destination country, for example CN.
arrival.port string true The full name of the destination port, for example Qingdao.
arrival.port.unlocode string true The UNLOCODE of the destination port.
cargo.barrels integer false The total number of barrels carried by this vessel during this journey.
cargo.draft float false The draft/draught level of this vessel as observed during this journey.
cargo.cargo_type string false The type of cargo carried by this vessel on this journey.
cargo.notes string true Relevant notes, if any, about this particular journey.

Still need help? Contact us

© 2018-2024 TankerTrackers.com, Inc.