[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

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.

Cargo + Past Track Tracking Request

Request URL

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

Execution Steps

In the Swagger Documentation, select Cargo from the Select a definition menu at the top right.

Navigate to /cargo/search/past-track.

Click [Try it out] to activate input fields.

Enter one of the following:

•

containerNo: Container Number

•

mblNo: Master B/L Number

•

bookingNo: Booking Number

Click [Execute].

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
carrierCode	CMAL	SCAC – 4-letter carrier code
bookingNo	SHZ5400465	Booking number
mblNo	SHZ5400465	Master Bill of Lading number
containerNo	BEAU2789169	Container number
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: 1. When Port of Loading (POL) or Port of Discharge (POD) information is not found 2. When the estimated arrival date at the Port of Discharge (POD) has not been set 3. When tracking fails temporarily within a certain period after initial cargo registration NOT_FOUND: Indicates permanent failure to retrieve cargo tracking information after repeated attempts
initialEtd	2025-01-01 00:00	First collected ETD after cargo registration
initialEta	2025-01-01 00:00	First collected ETA after cargo registration
bookingRegno	null	Booking confirmation number
srNo	null	Shipping request number
customColumn1	null	Custom fields for clients
customColumn2	null	Custom fields for clients
customColumn3	null	Custom fields for clients
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

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
locationSeq	0	Sequential order of each location within a partial shipment segment.
locationType	POL	POR: Place of Receipt POL: Port of Loading TSD: Transshipment Discharging TSL: Transshipment Loading POD: Port of Discharging PVY: Place of Delivery
carrierLocationCode	CNSHK	Port code from carrier
carrierLocationName	SHEKOU	Port name from carrier
carrierTerminalName	CMA CGM PSA LION TERMINAL	Terminal name from carrier
carrierEta	2025-01-01 00:00	Carrier’s Estimated Time of Arrival
carrierEtb	2025-01-01 00:00	Carrier’s Estimated Time of Berthing
carrierEtd	2025-01-01 00:00	Carrier’s Estimated Time of Departure
carrierAta	2025-01-01 00:00	Carrier’s Actual Time of Arrival
carrierAtb	2025-01-01 00:00	Carrier’s Actual Time of Berthing
carrierAtd	2025-01-01 00:00	Carrier’s Actual Time of Departure
carrierShipName	ANL WANGARATTA	Ship name from carrier
carrierVoyageNo	0WWE9W1MA	Voyage number from carrier
ata	2025-01-01 00:00	Actual Time of Arrival generated from SeaVantage Port Call data
atb	2025-01-01 00:00	Actual Time of Berthing generated from SeaVantage Port Call data
atd	2025-01-01 00:00	Actual Time of Departure generated from SeaVantage Port Call data
pta	2025-01-01 00:00	Predicted Time of Arrival (SeaVantage proprietary data)
imoNo	9334167	Ship’s 7-digit International Maritime Organization (IMO) registration number
port	[object Object]	Depth 3 → Refer to the port object

Depth 3 Field Description (port object)

Field	Example	Description
portId	47941f60-13b8-4718-bead-aa7c3c61d530	SeaVantage internal port classification
portName	Busan	Port name
unlocode	KRPUS	Port UN/LOCODE
nationCode	KR	Country code

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
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.
ciNo	null	Commercial invoice no.
shipperCode	null	Shipper code
shipperName	null	Shipper name
consigneeCode	null	Consignee code
consigneeName	null	Consignee name
ownerCode	null	Cargo owner code
ownerName	null	Cargo owner name
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
containerNo	BEAU2789169	Container number
hblNo	SVH.SHZ5400465	House B/L number
size	22	Container size
type	G1	Container type code
commodity	null	Cargo type
hscode	null	HS code (International Standard Commodity Code)
qty	null	Quantity
gw	null	Gross weight
sealNo1	null	Seal number #1
sealNo2	null	Seal number #2
sealNo3	null	Seal number #3
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
trackingSeq	0	Event sequence number per container
eventCode	EE	Event Code (See event code table below)
eventStatus	Actual	Event status (Actual, Estimate)
eventDescription1	EmptyDeliveredToShipper	Event description 1
eventDescription2	TRUCK	Event description 2
carrierEventTime	2025-01-01 00:00	Event timestamp
carrierLocationName	SHEKOU	Location name where the event occurred
unlocode	CNSHK	UN/LOCODE of the port where the event occurred
locationType	POL	Location type where the event occurred POL: Port of Loading TS: Transshipment POD: Port of Discharging

Depth 7 Field Description (pastTrack object)

Field	Example	Description
shipId	aaa9dcf0-6af2-4f89-a6d5-c25594ed9837	SeaVantage internal unique ship ID
imoNo	9637076	Ship’s 7-digit International Maritime Organization (IMO) registration number
mmsi	538005248	Ship’s 9-digit Maritime Mobile Service Identity (MMSI) registration number
shipName	ARDMORE SEAVANTAGE	Official registered name of the vessel
shipType	CONTAINER	Ship type (See shipType and shipTypeSize classification below)
shipTypeSize	CONTAINER03	Ship type/size (See shipType and shipTypeSize classification below)
nationCode	LR	Country code (flag state)
positions	[object Object]	Depth 8 → Refer to positions object

Depth 8 Field Description (positions object)

Field	Example	Description
imoNo	9637076	Ship’s 7-digit International Maritime Organization (IMO) registration number
mmsi	538005248	Ship’s 9-digit Maritime Mobile Service Identity (MMSI) registration number
deviceType	AIS	AIS Equipment Type
callSign	V7CD9	Ship's designated international call sign, used in maritime radio communications.
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)
aisDimA	150	Distance from the GPS antenna to the bow (See AIS dimension image below)
aisDimB	33	Distance from the antenna to the stern (See AIS dimension image below)
aisDimC	8	Distance from the antenna to the port (left) side (See AIS dimension image below)
aisDimD	24	Distance from the antenna to the starboard (right) side (See AIS dimension image below)
aisEta	05151000	AIS Estimated Time of Arrival (ETA)
aisDestination	HOUSTON FOR ORDER	AIS Destination
staticDateTime	2025-01-01T00:00:00Z	Static Information Reception Time: Refers to the time when static information about the vessel was last updated.
timestamp	2025-01-01T00:00:00Z	Position Information Reception Time: Represents the time when the AIS data was received.
aisClass	A	Class of AIS device: Class A (commercial) Class B (smaller vessels)
nvgStatus	0	Navigational Status (See Navigational Status table below)
rateOfTurn	0	Rate at which the vessel is turning, typically in degrees/min.
speedOverGround	1	Current vessel speed relative to the Earth’s surface (in knots).
positionAccuracy	0	Indicator of GPS precision 1 = high (<= 10 m) 0 = low (> 10 m) = default
longitude	-92.09995833	Vessel’s latest known position coordinate: longitude
latitude	27.45900833	Vessel’s latest known position coordinates: latitude
courseOverGround	312.8999938964844	Direction of the vessel’s movement (degrees)
trueHeading	229	Vessel’s actual heading direction
elapsed	0	Time delay (in minutes) since the last position update
utcSecond	45	UTC Second
dte	0	Data terminal equipment (DTE) ready 0 = available 1 = not available = default
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)
raimFlag	0	Receiver autonomous integrity monitoring (RAIM) flag of electronic position fixing device 0 = RAIM not in use = default 1 = RAIM in use
staticMessageNo	5	Static Message Number
locationMessageNo	1	Location Message Number
aisMaxDraught	8.1	In 1/10 m, 255 = draught 25.5 m or greater 0 = not available = default; In accordance with IMO Resolution A.851

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

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.