home

[GET] /cargo/search/past-track

This API provides cargo tracking information along with the vessel’s historical route, starting from its departure at the port of loading or transshipment port up to its most recent location. However, if the cargo has already been discharged at the port of discharge, the past track will only be available up to the completion of unloading.
  Go to Swagger Documentation

Authentication

The Cargo + Past Track API uses Basic Authorization in Swagger UI for user authentication.
Authentication Steps
1.
Click the [Authorize] button in the top right corner.
2.
Enter the provided username and password in the pop-up window.
3.
Click [Authorize] again to proceed with authentication.
4.
After successful login, click [Close] to close the window.
All API requests from Swagger UI will automatically include the authorization token.

Cargo + Past Track Tracking Request

Request URL

[GET] https://insight.seavantage.com/api/cargo/search/past-track

Execution Steps

1.
In the Swagger Documentation, select Cargo from the Select a definition menu at the top right.
2.
Navigate to /cargo/search/past-track.
3.
Click [Try it out] to activate input fields.
4.
Enter one of the following:
containerNo: Container Number
mblNo: Master B/L Number
bookingNo: Booking Number
5.
Click [Execute].
6.
View results in the response section.
Only cargo registered via [POST] /cargo can be queried using this API.

Response Information

The response is returned in the following format, regardless of whether the request is successful or failed.

Sample Response Format

{ "code": 200, "message": "OK", "error": false, "timestamp": "2024-12-01T12:00:00", "response": { "carrierCode": "string", "bookingNo": "string", "mblNo": "SOMEBILL2025001", "containerNo": "string", "blStatus": "BEFORE", "initialEtd": "2025-05-14T08:23:20.203Z", "initialEta": "2025-05-14T08:23:20.203Z", "bookingRegno": "00000000006201212335", "srNo": "SOMEBILL2025001", "customColumn1": "string", "customColumn2": "string", "customColumn3": "string", "locations": [ { "locationSeq": 0, "locationType": "string", "carrierLocationCode": "string", "carrierLocationName": "string", "carrierTerminalName": "string", "carrierEta": "2025-05-14T08:23:20.203Z", "carrierEtb": "2025-05-14T08:23:20.203Z", "carrierEtd": "2025-05-14T08:23:20.203Z", "carrierAta": "2025-05-14T08:23:20.203Z", "carrierAtb": "2025-05-14T08:23:20.203Z", "carrierAtd": "2025-05-14T08:23:20.203Z", "carrierShipName": "string", "carrierVoyageNo": "string", "ata": "2025-05-14T08:23:20.203Z", "atb": "2025-05-14T08:23:20.203Z", "atd": "2025-05-14T08:23:20.203Z", "pta": "2025-05-14T08:23:20.203Z", "imoNo": "string", "port": { "portId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "portName": "string", "unlocode": "string", "nationCode": "string", } } ], "hbls": [ { "hblNo": "string", "ciNo": "1234567890", "shipperCode": "string", "shipperName": "string", "consigneeCode": "string", "consigneeName": "string", "ownerCode": "string", "ownerName": "string", "containers": [ { "containerNo": "string", "hblNo": "string", "size": "string", "type": "string", "commodity": "string", "hscode": "string", "qty": 0, "gw": 0, "sealNo1": "string", "sealNo2": "string", "sealNo3": "string", "trackings": [ { "trackingSeq": 0, "eventCode": "string", "eventStatus": "string", "eventDescription1": "string", "eventDescription2": "string", "carrierEventTime": "string", "carrierLocationName": "string", "unlocode": "string", "locationType": "POR" } ] } ] } ], "pastTrack": [ { "shipId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "imoNo": "string", "mmsi": "string", "shipName": "string", "shipType": "string", "shipTypeSize": "string", "nationCode": "string", "positions": [ { "imoNo": "string", "mmsi": "string", "deviceType": "string", "callSign": "string", "shipName": "string", "aisShipType": 0, "aisDimA": 0, "aisDimB": 0, "aisDimC": 0, "aisDimD": 0, "aisEta": "string", "aisDestination": "string", "staticDateTime": "2025-05-14 08:23", "timestamp": "2025-05-14 08:23", "aisClass": "string", "nvgStatus": 0, "rateOfTurn": 0, "speedOverGround": 0, "positionAccuracy": 0, "longitude": 0, "latitude": 0, "courseOverGround": 0, "trueHeading": 0, "elapsed": 0, "utcSecond": 0, "dte": 0, "specialManeuverIndicator": "string", "raimFlag": "string", "staticMessageNo": 0, "locationMessageNo": 0, "aisMaxDraught": 0 } ] } ] } }
JavaScript
복사

Detailed Response Description

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
"OK"
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
null or Object
Returns cargo data if found Returns null if not found

Response Codes

Code
Description
200
Success
400
Bad Request
401
Unauthorized
403
Forbidden
422
Unprocessable Entity
429
Too Many Requests

Detailed Response Description

Field
Example
Description
Data Type
carrierCode
CMAL
SCAC – 4-letter carrier code
varchar(10)
bookingNo
SHZ5400465
Booking number
varchar(512)
mblNo
SHZ5400465
Master Bill of Lading number
varchar(128)
containerNo
BEAU2789169
Container number
varchar(64)
blStatus
END
PROCESSING: Tracking is in progress after the tracking request is made. BEFORE: The vessel has not yet departed from the Port of Loading (POL), before ATD occurs. ON: The vessel has departed from POL and has not yet arrived at the Port of Discharge (POD). END: ATA has occurred at the POD (the vessel has arrived at the Port of Discharge (POD). PENDING: Location data is currently unavailable. NOT_FOUND: The system failed to retrieve tracking information for the shipment. CLOSED: Container tracking has ended. EXPIRED: The system continuously failed to retrieve tracking data during container tracking.
varchar(10)
initialEtd
2025-01-01 00:00
First collected ETD after cargo registration
timestamp
initialEta
2025-01-01 00:00
First collected ETA after cargo registration
timestamp
bookingRegno
null
Booking confirmation number
varchar(20)
srNo
null
Shipping request number
varchar(20)
customColumn1
null
Custom fields for clients
text
customColumn2
null
Custom fields for clients
text
customColumn3
null
Custom fields for clients
text
locations
[object Object]
Depth 2 → location Fields
hbls
[object Object]
Depth 3 → hbls Fields
pastTrack
[object Object]
Depth 7 → pastTrack Fields
referenceType
MBL
Indicates which identifier was used when the cargo was initially registered for tracking. CONTAINER: Registered using a container number BOOKING: Registered using a booking number MBL: Registered using a Master B/L number
varchar(16)

Depth 2 Field Description (locations object)

locations provides information about each port (Location) that the cargo passes through. For each location type (e.g., POL, POD), you can also check time-related details such as ETA/ETD, ATA/ATD and PTA.
Field
Example
Description
Data Type
locationSeq
0
Sequential order of each location within a partial shipment segment.
smallint
locationType
POL
POR: Place of Receipt POL: Port of Loading TSD: Transshipment Discharging TSL: Transshipment Loading POD: Port of Discharging PVY: Place of Delivery
varchar(20)
carrierLocationCode
CNSHK
Port code from carrier
varchar(5)
carrierLocationName
SHEKOU
Port name from carrier
varchar(200)
carrierTerminalName
CMA CGM PSA LION TERMINAL
Terminal name from carrier
varchar(200)
carrierEta
2025-01-01 00:00
Carrier’s Estimated Time of Arrival
timestamp
carrierEtb
2025-01-01 00:00
Carrier’s Estimated Time of Berthing
timestamp
carrierEtd
2025-01-01 00:00
Carrier’s Estimated Time of Departure
timestamp
carrierAta
2025-01-01 00:00
Carrier’s Actual Time of Arrival
timestamp
carrierAtb
2025-01-01 00:00
Carrier’s Actual Time of Berthing
timestamp
carrierAtd
2025-01-01 00:00
Carrier’s Actual Time of Departure
timestamp
carrierShipName
ANL WANGARATTA
Ship name from carrier
varchar(128)
carrierVoyageNo
0WWE9W1MA
Voyage number from carrier
varchar(32)
ata
2025-01-01 00:00
Actual Time of Arrival generated from SeaVantage Port Call data
timestamp
atb
2025-01-01 00:00
Actual Time of Berthing generated from SeaVantage Port Call data
timestamp
atd
2025-01-01 00:00
Actual Time of Departure generated from SeaVantage Port Call data
timestamp
pta
2025-01-01 00:00
Predicted Time of Arrival (SeaVantage proprietary data)
timestamp
imoNo
9334167
Ship’s 7-digit International Maritime Organization (IMO) registration number
varchar(10)
port
[object Object]
Depth 3 → Refer to the port object

Depth 3 Field Description (port object)

Field
Example
Description
Data Type
portId
47941f60-13b8-4718-bead-aa7c3c61d530
SeaVantage internal port classification
varchar(36) - UUID
portName
Busan
Port name
varchar(255)
unlocode
KRPUS
Port UN/LOCODE
varchar(36)
nationCode
KR
Country code
varchar(36)

Depth 4 Field Description (hbls object)

hbls is an object that contains cargo information at the House B/L level. Multiple hbls can be associated with a single Master B/L, and if none are entered, they will be generated automatically.
Field
Example
Description
Data Type
hblNo
SVH.SHZ5400465
House B/L No. If the value is system-generated (no House B/L is entered), it will automatically begin with SVH.
varchar(38)
ciNo
null
Commercial invoice no.
varchar(50)
shipperCode
null
Shipper code
varchar(20)
shipperName
null
Shipper name
varchar(128)
consigneeCode
null
Consignee code
varchar(20)
consigneeName
null
Consignee name
varchar(128)
ownerCode
null
Cargo owner code
varchar(20)
ownerName
null
Cargo owner name
varchar(128)
containers
[object Object]
Depth 5 → Refer to the containers object

Depth 5 Field Description (containers object)

containers refers to an object that contains detailed information for each container included under a specific House B/L.
Field
Example
Description
Data Type
containerNo
BEAU2789169
Container number
varchar(30)
hblNo
SVH.SHZ5400465
House B/L number
varchar(38)
size
22
Container size
varchar(16)
type
G1
Container type code
varchar(64)
commodity
null
Cargo type
varchar(128)
hscode
null
HS code (International Standard Commodity Code)
varchar(20)
qty
null
Quantity
numeric(14,3)
gw
null
Gross weight
numeric(14,3)
sealNo1
null
Seal number #1
varchar(64)
sealNo2
null
Seal number #2
varchar(64)
sealNo3
null
Seal number #3
varchar(64)
trackings
[object Object]
Depth 6 → Refer to trackings object

Depth 6 Field Description (trackings object)

trackings presents the event history that occurred for a container, where each object corresponds to a single event.
Field
Example
Description
Data Type
trackingSeq
0
Event sequence number per container
smallint
eventCode
EE
varchar(12)
eventStatus
Actual
Event status (Actual, Estimate)
varchar(20)
eventDescription1
EmptyDeliveredToShipper
Event description 1
varchar(512)
eventDescription2
TRUCK
Event description 2
varchar(512)
carrierEventTime
2025-01-01 00:00
Event timestamp
varchar(20)
carrierLocationName
SHEKOU
Location name where the event occurred
varchar(200)
unlocode
CNSHK
UN/LOCODE of the port where the event occurred
varchar(36)
locationType
POL
Location type where the event occurred POL: Port of Loading TS: Transshipment POD: Port of Discharging
varchar(20)

Depth 7 Field Description (pastTrack object)

Field
Example
Description
Data Type
shipId
aaa9dcf0-6af2-4f89-a6d5-c25594ed9837
SeaVantage internal unique ship ID
UUID (36)
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
shipName
ARDMORE SEAVANTAGE
Official registered name of the vessel
varchar(100)
shipType
CONTAINER
varchar(36)
shipTypeSize
CONTAINER03
varchar(36)
nationCode
LR
Country code (flag state)
varchar(36)
positions
[object Object]
Depth 8 → Refer to positions object

Depth 8 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 the GPS antenna to the bow (See AIS dimension image below)
smallint
aisDimB
33
Distance from the antenna to the stern (See AIS dimension image below)
smallint
aisDimC
8
Distance from the antenna to the port (left) side (See AIS dimension image below)
smallint
aisDimD
24
Distance from the antenna to the starboard (right) side (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
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
smallint

Appendix

Types of Container Event Codes

Event codes represent the status, location movements, or other key updates related to a container.
Event Code
Description
I
In gate
AE
Loaded on vessel
VD
Vessel departure
VA
Vessel arrival
VB
Vessel berthing
UV
Unloaded from vessel
OA
Out gate
D
Delivered to the consignee
RD
Empty container returned
A
Arrived
AD
Appointment date/Time for delivery
AG
ETA Changed
AL
Loaded on rail
AM
Loaded on truck
AP
Loaded on feeder vessel
AR
Rail arrival at destination intermodal ramp
AV
Available for delivery
CO
Cargo received at contractual place of receipt
CR
Carrier release
CT
Customs released
CU
Carrier and customs released
FT
Free time expired
MT
Empty returned to CY
P
Full container issued
PA
Us customs hold
RL
Rail departure from original intermodal ramp
UR
Unloaded from rail
VE
Estimated vessel arrival
VT
Estimated vessel departure
X2
ETA at consignee location
C
Estimated to depart terminal location
CI
Passing
X6
En route to delivery location
R
Received from prior carrier
NO
Ocean charges paid
AW
Awaiting export
U
Unloading

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