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.
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 |