[GET] /fleet/class-b

This API retrieves the list of Class B vessels registered in Fleet, including vessel specification details and real-time position information. It is updated on average every 15 minutes based on AIS data.

Go to swagger Documentation

Authentication

The NonIMONo (Class B) Fleet API uses Basic Authorization for user authentication via Swagger UI.

The authentication procedure is as follows:

Click the [Authorize] button in the top-right corner.

Enter the provided credentials (username and password) in the pop-up dialog.

Click [Authorize] again to proceed with authentication.

Once authentication is complete, click [Close] to close the dialog.

All API requests executed from Swagger UI automatically include authentication credentials.

Request Information

Request Details

Request URL : [GET] https://insight.seavantage.com/api/fleet/class-b

Execution Steps

Open the Swagger Documentation and select NonIMONo(ClassB)  from the Select a definition menu.

Navigate to the /fleet/class-b  endpoint.

Click Try it out to enable the input fields.

The result is returned based on the request Parameters configuration.

•

No parameters : Retrieves all Class B vessels registered in the workspace.

•

categoryId only : Retrieves the list of Class B vessels registered under the specified category.

◦

categoryId must be a UUID.

◦

To add or view categoryId, contact to cx@seavantage.com

•

shipId only : Retrieves only the specified Class B vessel.

◦

shipId is a UUID and can be retrieved via the  /ship/class-b/search API.

•

categoryId + shipId : Retrieves only the specified Class B vessel within the specified category.

Click [Execute].

Review the result in the response section at the bottom.

Response Information

Response Example

{
  "code": 200,
  "message": "success",
  "error": false,
  "timestamp": "2025-12-18T06:06:23.963057840",
  "response": [
    {
      "ship": {
        "shipId": "01807ed0-dbb0-45b3-a836-e2dff5173dbb",
        "imoNo": "",
        "mmsi": "413833481",
        "callSign": null,
        "shipName": "ZHONG YI JI TONG",
        "shipAliasName": null,
        "shipType": null,
        "shipTypeBySize": null,
        "shipTypeCargo": null,
        "built": 0,
        "dwt": 0,
        "hullType": null,
        "gt": 0,
        "builtBy": null,
        "builtAt": null,
        "loa": 0,
        "depth": 0,
        "maxDraught": 26,
        "engineBuiltBy": null,
        "designedBy": null,
        "serviceSpeed": 0,
        "nationCode": null,
        "breadth": 0,
        "teuCapacity": 0,
        "liquidCapacity": 0,
        "destinationPortId": null,
        "pta": null,
        "ptb": null,
        "destinationTerminalName": null,
        "destinationUnlocode": null,
        "destinationPortName": null
      },
      "position": {
        "imoNo": "",
        "mmsi": "413833481",
        "deviceType": "AIS",
        "callSign": null,
        "shipName": "ZHONG YI JI TONG",
        "aisShipType": 70,
        "aisDimA": 10,
        "aisDimB": 79,
        "aisDimC": 13,
        "aisDimD": 3,
        "aisEta": "12192200",
        "aisDestination": "NAN JING",
        "staticDateTime": "2025-12-18T05:50:45Z",
        "timestamp": "2025-12-18T05:55:08Z",
        "aisClass": "B",
        "nvgStatus": 0,
        "rateOfTurn": 0,
        "speedOverGround": 7.5,
        "positionAccuracy": 1,
        "longitude": 119.96213,
        "latitude": 32.01666167,
        "courseOverGround": 320.79998779296875,
        "trueHeading": 0,
        "elapsed": 0,
        "utcSecond": 8,
        "dte": 0,
        "specialManeuverIndicator": "0",
        "raimFlag": "0",
        "staticMessageNo": 5,
        "locationMessageNo": 1,
        "aisMaxDraught": 2.8
      },
      "categoryIds": []
    }
  ]
}
JSON
복사

Response Field Details

Failure Response Field Definitions

Field	Example	Description
code	200	Response status code (Aligned with HTTP status code) (See the list of codes below for reference)
message	OK	Response message describing the result based on the status.
error	false	Indicates whether an error occurred true: error occurred false: success
timestamp	2024-12-01T12:00:00	Response generation time (UTC)
response	Array or empty array	Array when vessels exist; empty array when no vessels exist.

Response Status Codes

Code	Description
204	Deleted
400	Bad request
401	Unauthorized
403	Forbidden
422	Unprocessable entity
429	Too many requests

Detailed Response Description

Depth 1 Field Description (ship object)

Field	Example Value	Description	Data Type
shipId	b7ac555e-8b3a-11e9-b34d-54802853d888	SeaVantage unique vessel ID	varchar(36) - UUID
shipName	MAERSK MC-KINNEY MOLLER	Vessel name	varchar(100)
imoNo	9619907	Vessel IMO registration number	varchar(10)
mmsi	219018271	Vessel unique identifier	varchar(10)
callSign	OWIZ2	Call sign	varchar(7)

Depth 2 Field Description (position object)

Field	Example	Description	Data Type
imoNo	9637076	Ship’s 7-digit International Maritime Organization (IMO) registration number	varchar(20)
mmsi	538005248	Ship’s 9-digit Maritime Mobile Service Identity (MMSI) registration number	varchar(20)
deviceType	AIS	AIS Equipment Type	varchar(36)
callSign	V7CD9	Ship's designated international call sign, used in maritime radio communications.	varchar(7)
shipName	ARDMORE SEAVANTAGE	Official registered name of the vessel	varchar(36)
aisShipType	80	Vessel type classification code transmitted via the Automatic Identification System (AIS) (See separate AIS Ship Type table below)	smallint
aisDimA	150	- Distance from GPS antenna to bow - Direction: Forward (Bow) (See AIS dimension image below)	smallint
aisDimB	33	- Distance from GPS antenna to stern - Direction: Backward (Stern) (See AIS dimension image below)	smallint
aisDimC	8	- Distance from GPS antenna to port side - Direction: Left (Port) (See AIS dimension image below)	smallint
aisDimD	24	- Distance from GPS antenna to starboard side - Direction: Right (Starboard) (See AIS dimension image below)	smallint
aisEta	05151000	AIS Estimated Time of Arrival (ETA)	varchar(8)
aisDestination	HOUSTON FOR ORDER	AIS Destination	varchar(32)
staticDateTime	2025-01-01T22:22:56Z	Static Information Reception Time: Refers to the time when static information about the vessel was last updated.	timestamp
timestamp	2025-01-01T22:34:18Z	Position Information Reception Time: Represents the time when the AIS data was received.	timestamp
aisClass	A	Class of AIS device: Class A (commercial) Class B (smaller vessels)	char
nvgStatus	0	Navigational Status (See Navigational Status table below)	smallint
rateOfTurn	0	Rate at which the vessel is turning, typically in degrees/min.	real
speedOverGround	1	Current vessel speed relative to the Earth’s surface (in knots).	real
positionAccuracy	0	Indicator of GPS precision 1 = high (<= 10 m) 0 = low (> 10 m) = default	smallint
longitude	-92.09995833	Vessel’s latest known position coordinate: longitude	numeric(12, 8)
latitude	27.45900833	Vessel’s latest known position coordinates: latitude	numeric(12, 8)
courseOverGround	312.8999938964844	Direction of the vessel’s movement (degrees)	real
trueHeading	229	Vessel’s actual heading direction	smallint
elapsed	0	Time delay (in minutes) since the last position update	integer
utcSecond	45	UTC Second	smallint
dte	0	Data terminal equipment (DTE) ready 0 = available 1 = not available = default	smallint
specialManeuverIndicator	0	0 = not available = default 1 = not engaged in special maneuver 2 = engaged in special maneuver (i.e.: regional passing arrangement on Inland Waterway)	char
raimFlag	0	Receiver autonomous integrity monitoring (RAIM) flag of electronic position fixing device 0 = RAIM not in use = default 1 = RAIM in use	char
staticMessageNo	5	Static Message Number	smallint
locationMessageNo	1	Location Message Number	smallint
aisMaxDraught	8.1	Maximum Draught	real

Depth 3 Field Description (categoryIds object)

Field	Example	Description	Data Type
categoryIds	123e4567-e89b-12d3-a456-426614174000	SeaVantage internal category identifier	varchar(36) - UUID

Appendix

Ship Type by Size Classification

Bulk Carrier

Classification Code	Classification	Lower Range (DWT)	Higher Range (DWT)
BULK 05	Handysize	0	34,999
BULK 04	Handymax	35,000	59,999
BULK 03	Panamax	60,000	79,999
BULK 02	Capesize	80,000	179,999
BULK 01	VLBC	180,000

Chemical Tanker

Classification	Vessel Type	Classification
CHEMICAL_TANKER01	Product Tanker	Chemical tanker, combined chemical and oil tanker

Container

Classification Code	Classification	Lower Range (TEU)	Higher Range (TEU)
CONTAINER 07	Small Feeder	0	1,000
CONTAINER 06	Feeder Containership	1,001	2,000
CONTAINER 05	Feedermax Containership	2,001	3,000
CONTAINER 04	Panamax Containership	3,001	5,100
CONTAINER 03	Post-Panamax Containership	5,101	10,000
CONTAINER 02	Neo-Panamax Containership	10,001	14,500
CONTAINER 01	ULCV Containership	14,501

Cargo

Classification Code	Classification	Lower Range (DWT)	Higher Range (DWT)
CARGO 04	General Cargo	0	2,999
CARGO 03	General Cargo	3,000	7,499
CARGO 02	General Cargo	7,500	37,999
CARGO 01	General Cargo	38,000

LNG

Classification Code	Classification	Lower Range (Gross Tonnes)	Higher Range (Gross Tonnes)
LNG 03	LNG Gas Carrier	0	73,000
LNG 02	LNG Gas Carrier	73,001	147,000
LNG 01	LNG Gas Carrier	147,001

LPG

Classification Code	Classification	Lower Range (Gross Tonnes)	Higher Range (Gross Tonnes)
LPG 03	LPG Gas Carrier	0	4,500
LPG 02	LPG Gas Carrier	4,501	26,000
LPG 01	LPG Gas Carrier	26,001

Pure Car Carrier (PCC)

Classification Code	Classification	Lower Range (Gross Tonnes)	Higher Range (Gross Tonnes)
PCC 03	PCC/PCTC	0	35,000
PCC 02	PCC/PCTC	35,001	61,000
PCC 01	PCC/PCTC	61,001

Ro-ro

Classification Code	Classification	Lower Range (Gross Tonnes)	Higher Range (Gross Tonnes)
RORO 03	Ro-ro Cargo	0	0
RORO 02	Ro-ro Cargo	8,501	48,000
RORO 01	Ro-ro Cargo	48,001

Tanker

Classification Code	Vessel Type	Classification
TANKER 05	Crude Oil Tanker	Tanker- Panamax
TANKER 04	Crude Oil Tanker	Tanker- Aframax
TANKER 03	Crude Oil Tanker	Tanker- Suezmax
TANKER 02	Crude Oil Tanker	Tanker- VLCC
TANKER 01	Crude Oil Tanker	Tanker- ULCC

Product Tanker

Classification	Vessel Type
PRODUCT_TANKER01	Product Tanker

Tug

Classification	Vessel Type
TUG01	Tug

FPSO

Classification	Vessel Type	Classification
FPSO01	FPSO	Floating drilling production tanker, floating gas production, floating gas storage, floating LNG production and storage FLNG, floating power station, floating production tanker, floating storage tanker

ETC

Classification	Vessel Type
ETC01	ETC All

AIS Dimension

	Number of bits	Bit fields	Distance (m)
A	9	Bit 21 - Bit 29	0 - 511: 511 = 511m or greater
B	9	Bit 12 - Bit 20	0 - 511: 511 = 511m or greater
C	6	Bit 6 - Bit 11	0 - 63: 63 = 63m or greater
D	6	Bit 0 - Bit 5	0 - 63: 63 = 63m or greater

The A value should be entered on the vessel’s heading direction (bow).

•

When the reference point of the reported position is unavailable, but dimension information is provided:

◦

A = C = 0, and B ≠ 0, D ≠ 0

•

When both the reference point and dimension information are unavailable:

◦

A = B = C = D = 0 (default)

•

In the message table:

◦

A is the most significant field, D is the least significant field

AIS Ship Type

Type Code	Description	Type Code	Description
0	Not available (default)	58	Medical Transport
1–19	Reserved for future use	59	Noncombatant ship according to RR Resolution No. 18
20	Wing in ground (WIG), all ships of this type	60	Passenger, all ships of this type
21	Wing in ground (WIG), Hazardous category A	61	Passenger, Hazardous category A
22	Wing in ground (WIG), Hazardous category B	62	Passenger, Hazardous category B
23	Wing in ground (WIG), Hazardous category C	63	Passenger, Hazardous category C
24	Wing in ground (WIG), Hazardous category D	64	Passenger, Hazardous category D
25–29	Wing in ground (WIG), Reserved for future use	65–68	Passenger, Reserved for future use
30	Fishing	69	Passenger, No additional information
31	Towing	70	Cargo, all ships of this type
32	Towing: length exceeds 200m or breadth exceeds 25m	71	Cargo, Hazardous category A
33	Dredging or underwater ops	72	Cargo, Hazardous category B
34	Diving ops	73	Cargo, Hazardous category C
35	Military ops	74	Cargo, Hazardous category D
36	Sailing	75–78	Cargo, Reserved for future use
37	Pleasure Craft	79	Cargo, No additional information
38–39	Reserved	80	Tanker, all ships of this type
40	High speed craft (HSC), all ships of this type	81	Tanker, Hazardous category A
41	High speed craft (HSC), Hazardous category A	82	Tanker, Hazardous category B
42	High speed craft (HSC), Hazardous category B	83	Tanker, Hazardous category C
43	High speed craft (HSC), Hazardous category C	84	Tanker, Hazardous category D
44	High speed craft (HSC), Hazardous category D	85–88	Tanker, Reserved for future use
45–48	High speed craft (HSC), Reserved for future use	89	Tanker, No additional information
49	High speed craft (HSC), No additional information	90	Other Type, all ships of this type
50	Pilot Vessel	91	Other Type, Hazardous category A
51	Search and Rescue vessel	92	Other Type, Hazardous category B
52	Tug	93	Other Type, Hazardous category C
53	Port Tender	94	Other Type, Hazardous category D
54	Anti-pollution equipment	95–98	Other Type, Reserved for future use
55	Law Enforcement	99	Other Type, no additional information
56–57	Spare - Local Vessel

AIS Navigation Status Description

Code	Status	Description
0	Under way using engine	The vessel is actively moving through the water under engine power.
1	At anchor	The vessel is anchored and stationary.
2	Not under command	The vessel is unable to maneuver due to exceptional circumstances, such as engine failure or loss of steering. Other vessels should navigate with caution.
3	Restricted maneuverability	The vessel's ability to maneuver is limited due to operations or environmental conditions. Other vessels should keep clear.
4	Constrained by her draught	The vessel is restricted in its ability to deviate from its course due to its deep draught relative to water depth.
5	Moored	The vessel is secured by mooring lines, typically tied to a dock or port facility.
6	Aground	The vessel has run aground and is stuck in shallow water. It is immobile until freed.
7	Engaged in fishing	The vessel is currently engaged in fishing operations. Navigating vessels should allow space, as nets or lines may be deployed.
8	Under way sailing	Indicates that the vessel is currently sailing. This may include movement using sails instead of engine power.
9	Reserved for future amendment of navigational status	This value is reserved for future use to represent a specific navigation status not yet defined.
10	Reserved for future amendment of navigational status	This value is reserved for future use to represent a specific navigation status not yet defined.
11	Power-driven vessel towing astern (regional use)	The vessel is towing another vessel behind it. Most commonly used by tugboats.
12	Power-driven vessel pushing ahead or towing alongside (regional use)	The vessel is pushing another vessel ahead or towing it alongside. Common in inland waterway operations.
13	Reserved for future use	Reserved by standard bodies for future status codes.
14	AIS-SART (active), MOB-AIS, EPIRB-AIS	Distress-related AIS devices are active: AIS-SART (Search and Rescue Transponder), MOB-AIS (Man Overboard), or EPIRB-AIS (Emergency Beacon). Immediate attention may be required.
15	Undefined = default (also used by AIS-SART, MOB-AIS and EPIRB-AIS under test)	Represents the default status when the vessel’s navigation state is not explicitly defined.