Endpoint: Tagged Satellite Locations

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 list of visually confirmed satellite locations for a vessel, time range, or both.

Endpoint URL:

https://tankertrackers.com/api/sl/v2/[API Key]?[parameters]

Note that all four parameters; imo, polygon, from and to are optional, but at least one must be included. They must also be entered in a key=value system, such as ?imo=1234567&from=2024-01-01&to=2024-01-14

URL Parameters:

Parameter Description
[API Key] The Unique API Key as indicated on the Account Management page.
[imo] The IMO of the vessel you wish to see the satellite locations for.
[polygon] The numeric ID of a polygon as indicated in the Polygon API.
[from] The starting date of the range you are interested in, for example 2021-01-01.
[to] The ending date of the range you are interested in, for example 2021-02-28.

The resulting output is a JSON array containing one JSON object per visually confirmed satellite location, with additional details available for context.

Response Keys:

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

JSON Key Name JSON Value Type Nullable? Description
vessel_name string false The current name of the vessel according to the best of our understanding.
vessel_imo integer false The IMO of the vessel.
datetime datetime string false The date and time that the vessel was located, in YYYY-MM-DD HH:MM:SS format. Time 00:00:00 will be shown for all where time was unknown.
laden_status string true Whether the vessel was laden or empty at the time.
polygon string true The polygon the vessel was in when the satellite image was captured.
latitude float false The latitude of the vessel when located.
longitude float false The longitude of the vessel when located.
spoofing boolean false Whether or not the vessel was spoofing AIS signals at the time.
external_link string true An URL to an external site showing this vessel at this location, where available.

Still need help? Contact us

© 2018-2024 TankerTrackers.com, Inc.