Vessels Details#
Returns detailed information about vessels, their position, and detailed predictions incl. prediction scores about their next destination.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/vessels/details |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.vessels_details
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 date when the vessel was first active in the system. |
2025-07-27T22:43:41.371622+00:00 |
first_operation_date |
string |
The 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. |
False |
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 |
number |
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 |
route_score |
number |
The forecast route score is the product of forecast scores along a given forecast route. |
0.75 |
route_score_weighted_volume |
number |
The forecast volume multiplied by the forecast route score. |
1000.0 |
score |
number |
The forecast score is the probability of a single forecast. |
0.85 |
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 |
number |
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 |
forecast_destination_terminal |
forecast_destination_terminal_id |
forecast_destination_timestamp |
score |
route_score |
route_score_weighted_volume |
vessel_type |
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 |
Mugardos R |
terminal_7e1c3aad4 |
2026-01-30 12:38:38.240232+00 |
0.5138481877366263 |
0.5138481877366263 |
1352063.043981998 |
FSRU |
ACTIVE |
0.0 |
151.0 |
2025-05-15 16:56:38.600115 |
|||||
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 |
Mugardos L |
terminal_4264329f1 |
2026-01-05 15:08:03.355608+00 |
0.48615181226337356 |
0.48615181226337356 |
1279186.9560180018 |
FSRU |
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 |
Exemplar FSRU Inkoo _L |
terminal_92b65e188 |
2026-01-21 16:42:53.511386+00 |
0.18121723342225612 |
0.18121723342225612 |
648.4858698015436 |
BUNKERING_TANKER |
ACTIVE |
0.0 |
87.0 |
2025-05-15 16:56:38.60013 |
|||||
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 |
Porvoo Refinery _L |
terminal_839af124a |
2026-02-02 11:31:52.72376+00 |
0.1797298135248561 |
0.1797298135248561 |
643.1631376986975 |
BUNKERING_TANKER |
ACTIVE |
0.0 |
87.0 |
2025-05-15 16:56:38.60013 |
|||||
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 |
Pori L |
terminal_0ceb73612 |
2026-01-23 05:30:50.487145+00 |
0.1664444480970681 |
0.1664444480970681 |
595.6214575153582 |
BUNKERING_TANKER |
ACTIVE |
0.0 |
87.0 |
2025-05-15 16:56:38.60013 |
|||||
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 |
Exemplar FSRU Inkoo _R |
terminal_bf0f8378e |
2026-02-11 01:42:03.712402+00 |
0.1661927807706394 |
0.1661927807706394 |
594.7208659877331 |
BUNKERING_TANKER |
ACTIVE |
0.0 |
87.0 |
2025-05-15 16:56:38.60013 |
|||||
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 |
Pori R |
terminal_c9d4b3a9b |
2026-01-23 02:02:42.998629+00 |
0.15589521846490142 |
0.15589521846490142 |
557.8710392766498 |
BUNKERING_TANKER |
ACTIVE |
0.0 |
87.0 |
2025-05-15 16:56:38.60013 |
|||||
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 |
Sweden12_L |
terminal_378482211 |
2025-12-10 14:46:21.299393+00 |
0.1505205057202788 |
0.1505205057202788 |
538.6376297200177 |
BUNKERING_TANKER |
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 |
GTA Phase 1 |
terminal_5f4bddbdc |
2025-12-26 02:03:48.2048+00 |
1.0 |
1.0 |
2576267.4 |
FPSO |
ACTIVE |
0.0 |
39.0 |
2025-05-15 16:56:38.600144 |