Vessels#
Returns detailed information about vessels, their position, and next most likely destination.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/vessels |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.vessels
Parameters#
Parameter |
Type |
Description |
Example |
|---|---|---|---|
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]]] |
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 |
forecast_destination_terminal |
forecast_destination_terminal_id |
forecast_destination_timestamp |
status |
speed |
heading |
charterer |
flag_state |
first_active_date |
first_operation_date |
modified_at |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
vessel_53488763a |
7361922 |
538003805.0 |
ENERGOS FREEZE |
V7TH4 |
287 |
43 |
125000.0 |
CUBIC_METER |
43.4729833333333 |
-8.23480666666667 |
2025-07-23 14:43:26 |
TBA |
2025-10-04 10:00:00 |
FSRU |
Mugardos R |
terminal_7e1c3aad4 |
2026-01-30 12:38:38.240232+00 |
ACTIVE |
0.0 |
151.0 |
2025-05-15 16:56:38.600115 |
|||||
vessel_c0490664e |
7382691 |
265704520.0 |
SEAGAS |
SDMO |
50 |
11 |
170.0 |
CUBIC_METER |
60.4436166666667 |
22.217965 |
2025-07-23 14:56:54 |
FITKU |
2025-02-28 18:00:00 |
BUNKERING_TANKER |
Pori R |
terminal_c9d4b3a9b |
2026-01-23 02:02:42.998629+00 |
ACTIVE |
0.0 |
87.0 |
2025-05-15 16:56:38.60013 |
|||||
vessel_90a55c39d |
7382720 |
538004197.0 |
HILLI EPISEYO |
V7VR8 |
293 |
62 |
124890.0 |
CUBIC_METER |
3.01674333333333 |
9.83808166666667 |
2025-07-23 14:05:12 |
KRIBI |
2024-11-19 20:00:00 |
FLNG |
ACTIVE |
0.1 |
216.0 |
2025-05-15 16:56:38.600137 |
||||||||
vessel_b81ddcdce |
7382732 |
538004196.0 |
GIMI |
V7VR7 |
294 |
42 |
122388.0 |
CUBIC_METER |
16.064705 |
-16.6038766666667 |
2025-07-23 14:53:15 |
GTA HUB |
2025-01-15 07:00:00 |
FPSO |
GTA Phase 1 |
terminal_5f4bddbdc |
2025-12-26 02:03:48.2048+00 |
ACTIVE |
0.0 |
39.0 |
2025-05-15 16:56:38.600144 |
|||||
vessel_01674d489 |
7382744 |
525015954.0 |
NUSANTARA REGAS 1 |
POIN |
293 |
41 |
125000.0 |
CUBIC_METER |
-5.97524666666667 |
106.799278333333 |
2025-07-23 14:42:30 |
FIXED MOORED |
FSRU |
ACTIVE |
0.0 |
511.0 |
2025-05-15 16:56:38.600151 |
|||||||||
vessel_6c6f2c4d6 |
7390143 |
538001388.0 |
GULF ENERGY |
V7BW9 |
285 |
44 |
123950.0 |
CUBIC_METER |
59.35908 |
5.29990833333333 |
2025-07-23 14:57:53 |
HAUGESUND |
2025-01-01 09:00:00 |
LNG_CARRIER |
ACTIVE |
0.0 |
511.0 |
2025-05-15 16:56:38.600158 |
||||||||
vessel_69bd967fa |
7390181 |
525001084.0 |
LNG AQUARIUS |
POJV |
285 |
44 |
126300.0 |
CUBIC_METER |
-5.952085 |
106.77307666666668 |
2021-12-19 08:15:33 |
2022-04-07 04:00:00 |
LNG_CARRIER |
ACTIVE |
0.0 |
511.0 |
2025-05-15 16:56:38.600179 |
|||||||||
vessel_f53bccae6 |
7428433 |
533192000.0 |
FSU TENAGA EMPAT |
9MUG |
280 |
42 |
130000.0 |
CUBIC_METER |
2.25770333333333 |
102.100303333333 |
2025-07-23 14:56:31 |
FSO |
ACTIVE |
0.0 |
511.0 |
2025-05-15 16:56:38.600221 |
||||||||||
vessel_318d50877 |
7428457 |
533189000.0 |
FSU TENAGA SATU |
9MUO |
281 |
41 |
130000.0 |
CUBIC_METER |
2.25479833333333 |
102.103103333333 |
2025-07-23 14:55:49 |
MY SUNGAI UDANG |
2024-12-14 20:00:00 |
FSRU |
ACTIVE |
0.0 |
511.0 |
2025-05-15 16:56:38.600228 |
||||||||
vessel_7a53a40f4 |
8125868 |
249320000.0 |
ARMADALNGMEDITERRANA |
9HA4196 |
283 |
45 |
127209.0 |
CUBIC_METER |
35.8278033333333 |
14.5540516666667 |
2025-07-23 14:58:09 |
MARSAXLOKK,MALTA |
2025-10-18 22:55:00 |
LNG_CARRIER |
ACTIVE |
0.0 |
511.0 |
2025-05-15 16:56:38.600271 |