Vessels History#
Returns detailed information about vessel activity and their position history.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/vessels/history |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.vessels_history
Parameters#
Parameter |
Type |
Description |
Example |
|---|---|---|---|
from_timestamp |
string |
The start UTC timestamp to filter the vessels. |
2025-07-27T22:43:41.371622+00:00 |
imos |
integer |
A list of IMO numbers to filter the vessels. |
[9771523] |
mmsis |
integer |
A list of MMSI numbers to filter the vessels. |
[249557000] |
names |
string |
A list of vessel names to filter the vessels. |
[‘INEOS INTUITION’, ‘LNG ENDEAVOUR’] |
polygons |
array |
A closed list of closed EPSG:4326 lon, lat coordinate pairs to filter by. |
[[[99.6, 1.0], [99.6, 7.5], [104.5, 7.5], [104.5, 1.0], [99.6, 1.0]], [[109.0, 1.0], [109.0, 7.5], [115.0, 7.5], [115.0, 1.0], [109.0, 1.0]]] |
to_timestamp |
string |
The end UTC timestamp to filter the vessels. |
2025-07-27T22:43:41.371622+00:00 |
Response Details#
Parameter |
Type |
Description |
Example |
|---|---|---|---|
callsign |
string |
The international radio call sign assigned to the vessel. |
9HA4285 |
captains_destination |
string |
The destination provided by the vessel’s captain. |
NORAF>USMAH |
captains_eta |
string |
The estimated time of arrival at the destination provided by the vessel’s captain. |
2025-07-27T22:43:41.371622+00:00 |
charterer |
string |
The name of the charterer of the vessel. |
SHELL |
first_active_date |
string |
The UTC date when the vessel was first active in the system. |
2025-07-27T22:43:41.371622+00:00 |
first_operation_date |
string |
The UTC date when the vessel first started operations. |
2025-07-27T22:43:41.371622+00:00 |
flag_state |
string |
The flag state of the vessel, indicating the country under which the vessel is registered. |
USA |
forecast_destination_terminal |
string |
The terminal where the vessel is forecasted to arrive. |
Gibbstown LNG |
forecast_destination_terminal_id |
string |
The unique identifier for the forecasted destination terminal. |
terminal_28c27df09 |
forecast_destination_timestamp |
string |
The UTC timestamp of the forecasted destination. |
2025-07-27T22:43:41.371622+00:00 |
heading |
number |
The current heading of the vessel in degrees. |
511.0 |
imo |
integer |
International Maritime Organization number identifying the vessel. |
9771523 |
is_loaded |
boolean |
Indicates whether the vessel is currently loaded with cargo. |
True |
last_ais_signal_timestamp |
string |
The UTC timestamp of the last received AIS signal from the vessel. |
2025-07-27T22:43:41.371622+00:00 |
latitude |
number |
The current latitude of the vessel in decimal degrees. |
39.1794283333333 |
length |
integer |
The overall length of the vessel in meters |
180 |
longitude |
number |
The current longitude of the vessel in decimal degrees. |
-70.1175833333333 |
maximum_capacity |
number |
The maximum capacity of the vessel in cubic meters. |
27500.0 |
maximum_capacity_unit |
string |
The unit of measurement for the maximum capacity. |
CUBIC_METER |
mmsi |
integer |
The Maritime Mobile Service Identity, a unique 9-digit identifier for maritime communications. |
249557000 |
modified_at |
string |
The UTC timestamp of the last modification to the vessel’s information in the database. |
2025-07-27T22:43:41.371622+00:00 |
name |
string |
The name of the vessel. |
INEOS INTUITION |
speed |
number |
The current speed of the vessel in knots. |
11.1 |
status |
string |
The current status of the vessel, such as “active”, “inactive”, etc. |
ACTIVE |
vessel_type |
string |
The type of vessel, such as “LNG Tanker”, etc. |
COMBINATION_GAS_CARRIER |
width |
integer |
The overall width of the vessel in meters |
26 |
Normal Output#
vessel_id |
imo |
mmsi |
name |
callsign |
length |
width |
maximum_capacity |
maximum_capacity_unit |
is_loaded |
latitude |
longitude |
last_ais_signal_timestamp |
captains_destination |
captains_eta |
vessel_type |
status |
speed |
heading |
charterer |
flag_state |
first_active_date |
first_operation_date |
modified_at |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
40.936863333333335 |
-63.17172333333333 |
2019-06-20 18:10:07 |
US MAH>GB GRG |
2019-06-28 13:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
16.4 |
78.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
56.05162166666667 |
-3.136791666666667 |
2020-04-20 00:00:33 |
USMAH |
2020-04-28 18:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
6.2 |
105.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
29.391016666666665 |
-39.82627333333333 |
2020-01-16 01:08:46 |
GB GRG>US HOU |
2020-01-24 12:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
15.3 |
254.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
56.11724166666666 |
-2.7066866666666667 |
2020-04-20 01:00:25 |
USMAH |
2020-04-28 18:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
16.5 |
80.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
29.32916166666667 |
-40.06865666666667 |
2020-01-16 02:01:29 |
GB GRG>US HOU |
2020-01-24 12:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
15.3 |
254.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
56.17082333333333 |
-2.2675983333333334 |
2020-04-20 02:02:33 |
USMAH |
2020-04-28 18:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
16.6 |
72.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
29.260590000000004 |
-40.32893666666666 |
2020-01-16 02:58:35 |
GB GRG>US HOU |
2020-01-24 12:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
14.7 |
254.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
29.257981666666666 |
-40.338276666666665 |
2020-01-16 03:00:41 |
GB GRG>US HOU |
2020-01-24 12:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
14.8 |
254.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
56.91708833333333 |
-1.7481766666666667 |
2020-04-20 05:00:17 |
USMAH |
2020-04-28 18:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
17.2 |
17.0 |
2025-05-15 16:56:38.60408 |
|||||
vessel_7bde846f2 |
9771523 |
249557000 |
JS INEOS INTUITION |
9HA4285 |
180 |
26 |
27500.0 |
CUBIC_METER |
29.16572333333333 |
-40.67365333333333 |
2020-01-16 04:13:57 |
GB GRG>US HOU |
2020-01-24 12:00:00 |
COMBINATION_GAS_CARRIER |
ACTIVE |
15.1 |
254.0 |
2025-05-15 16:56:38.60408 |