This API retrieves the list of Class B vessels registered in Fleet, including vessel specification details and real-time position information.
Authentication
The NonIMONo (Class B) Fleet API uses Basic Authorization for user authentication via Swagger UI.
The authentication procedure is as follows:
1.
Click the [Authorize] button in the top-right corner.
2.
Enter the provided credentials (username and password) in the pop-up dialog.
3.
Click [Authorize] again to proceed with authentication.
4.
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
1.
2.
/fleet/class-b 경로로 이동합니다.
3.
[Try it out] 버튼을 클릭하여 입력창을 활성화합니다.
4.
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.
◦
•
shipId only : Retrieves only the specified Class B vessel.
◦
•
categoryId + shipId : Retrieves only the specified Class B vessel within the specified category.
5.
Click [Execute].
6.
Review the result in the response section at the bottom.
7.
Response Information
Response Example
{
"code": 200,
"message": "success",
"error": false,
"timestamp": "2025-12-19T08:07:27.018050541",
"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
},
"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 |
응답 상세 설명
Depth 1 Field Description (ship object)
Field | Example | Description | Data Type |
shipId | 01807ed0-dbb0-45b3-a836-e2dff5173dbb | SeaVantage internal vessel identifier | varchar(36) - UUID |
imoNo | - | IMO number | varchar(10) |
mmsi | 413833481 | MMSI (Maritime Mobile Service Identity) | varchar(10) |
callSign | null | Vessel call sign | varchar(7) |
shipName | ZHONG YI JI TONG | Vessel name | varchar(100) |
shipAliasName | null | Vessel alias name | varchar(36) |
shipType | null | Vessel type
AIS Ship Type (see the table below) | varchar(36) |
shipTypeBySize | null | Vessel type by size
AIS Ship Type (아래 표 참고) | varchar(36) |
shipTypeCargo | null | Cargo type | varchar(50) |
built | 0 | Year built | smallint |
dwt | 0 | Deadweight tonnage (DWT) | integer |
hullType | null | Hull type | varchar(36) |
gt | 0 | Gross tonnage (GT) | integer |
builtBy | null | Shipbuilder | varchar(200) |
builtAt | null | Place of build | varchar(50) |
loa | 0 | Length overall (LOA) | real |
depth | 0 | Depth | real |
maxDraught | 26 | Maximum draught | real |
engineBuiltBy | null | Engine manufacture | varchar(200) |
designedBy | null | Designer | varchar(200) |
serviceSpeed | 0 | Service speed (knots) | real |
nationCode | null | Flag / nationality code | varchar(3) |
breadth | 0 | Breadth (beam) | real |
teuCapacity | 0 | TEU capacity | integer |
liquidCapacity | 0 | Liquid cargo capacity | integer |
destinationPortId | null | Internal destination port identifier | varchar(36) - UUID |
pta | null | Predicted Time of Arrival (Provided by SeaVantage) | timestamp |
ptb | null | Predicted Time of Berth (Provided by SeaVantage) | timestamp |
destinationTerminalName | null | Destination terminal name | varchar(128) |
destinationUnlocode | null | Destination UN/LOCODE | varchar(36) |
destinationPortName | null | Destination port name | varchar(255) |
Depth 2 Field Description (categoryIds object)
필드명 | 예시 값 | 설명 | 데이터 타입 |
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 |