[GET] /ship/class-b/position/area

This API retrieves information on Class B vessels located within a defined area, including their corresponding AIS data. It is updated on average every 15 minutes based on AIS data.

Go to Swagger Documentation

Authentication

The NonIMONo(ClassB) Ship API uses Basic Authorization on Swagger UI.

Authentication Steps

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

Enter the provided username and password in the pop-up window.

Click [Authorize] again to proceed with authentication.

After successful login, click [Close] to close the window.

All API requests from Swagger UI will automatically include the authorization token.

Request Information

Request URL

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

Execution Steps

In the Swagger Documentation, select NonIMONo(ClassB)  from the Select a definition menu at the top right.

Navigate to the /ship/class-b/position/area endpoint.

Click [Try it out] to activate input fields.

Click the [Execute] button.

View results in the response section.

Response Information

Sample Response Format

{
  "code": 200,
  "message": "OK",
  "error": false,
  "timestamp": "2024-12-01T12:00:00",
  "response": [
    {
      "info": {
        "shipId": "47941f60-13b8-4718-bead-aa7c3c61d530",
        "imoNo": "1234567",
        "mmsi": "123456789",
        "callSign": "ABC1234",
        "shipName": "Ship Name",
        "shipType": "CARGO",
        "shipTypeBySize": "CARGO01",
        "nationCode": "KR",
        "built": 2020,
        "dwt": 20000
      },
      "position": {
        "imoNo": "1234567",
        "mmsi": "123456789",
        "deviceType": "AIS",
        "callSign": "ABC1234",
        "shipName": "Ship Name",
        "aisShipType": 0,
        "aisDimA": 100,
        "aisDimB": 50,
        "aisDimC": 10,
        "aisDimD": 20,
        "aisEta": "04011300",
        "aisDestination": "BUSAN",
        "staticDateTime": "2025-12-29T04:31:43.589Z",
        "timestamp": "2025-12-29T04:31:43.589Z",
        "aisClass": "A",
        "nvgStatus": 0,
        "rateOfTurn": 0.5,
        "speedOverGround": 12.5,
        "positionAccuracy": 1,
        "longitude": 126.5,
        "latitude": 37.5,
        "courseOverGround": 180,
        "trueHeading": 180,
        "elapsed": 0,
        "utcSecond": 30,
        "dte": 1,
        "specialManeuverIndicator": "1",
        "raimFlag": "1",
        "staticMessageNo": 1,
        "locationMessageNo": 1,
        "aisMaxDraught": 10.5
      }
    }
  ]
}
JSON
복사

Response Field Descriptions

Top-Level Response Fields

Field	Example Value	Description
code	200	Response status code (used in the same way as standard HTTP status codes). See the list of codes below for reference.
message	success	Response message (description based on status)
error	false	Error flag true: error occurred false: successful processing
timestamp	2025-05-14T01:09:00.834665213	Time of response creation (UTC)
response	Array or empty array	Returns an array, or an empty array if no data is available.

Response Codes

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

Detailed Response Description

Depth 1 Field Description (info object)

Field	Example Value	Description	데이터 타입
shipId	01807ed0-dbb0-45b3-a836-e2dff5173dbb	SeaVantage internal unique ship ID	varchar(36) - UUID
imoNo	1234567	Ship’s 7-digit International Maritime Organization (IMO) registration number	varchar(10)
mmsi	123456789	Ship’s 9-digit Maritime Mobile Service Identity (MMSI) registration number	varchar(10)
callSign	ABC1234	Ship's designated international call sign, used in maritime radio communications.	varchar(7)
shipName	ZHONG YI JI TONG	Official registered name of the vessel	varchar(100)
shipType	null	Ship type classification (See shipType and shipTypeSize classification below )	varchar(36)
shipTypeBySize	null	Ship type by size classification (See shipType and shipTypeSize classification below )	varchar(36)
nationCode	null	Country code (flag state)	varchar(3)
built	0	Year built	smallint
dwt	0	Deadweight tonnage (DWT)	integer

Depth 2 Field Description (position object)

Field	Example Value	Description	데이터 타입
imoNo	9637076	Ship’s 7-digit International Maritime Organization (IMO) registration number	varchar(10)
mmsi	538005248	Ship’s 9-digit Maritime Mobile Service Identity (MMSI) registration number	varchar(10)
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	선박 별칭
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-01T00:00:00Z	Static Information Reception Time: Refers to the time when static information about the vessel was last updated.	timestamp
timestamp	2025-01-01T00:00:00Z	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

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

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

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

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 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 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 Navigation Status

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.