home

Shipment Tracking

Track bookings, B/Ls, and containers from major carriers, terminals, and ports—all in one platform. Gain access to real-time vessel locations, accurate estimated time of arrival (ETA), and end-to-end visibility.

Steps to Use the Screen Embed Service

1. Token Issuance

Issue the user token.

Request URL

[GET] https://insight.seavantage.com/api/token/publish

Execution Steps

1.
In the Swagger Documentation, select Token from the Select a definition menu at the top right.
2.
Navigate to /token/publish.
3.
Click [Try it out] to activate input fields.
4.
Click [Execute].
5.
View results in the response section.
Notes
Tokens are valid for 24 hours. To maintain continuous access, it is recommended to renew them every 12 hours.
This API can be called multiple times, but only the two most recently issued tokens remain valid. Previously issued tokens are automatically expired.
 View the Detailed Token API guide

2. Embed URL Generation

After issuing the token, combine it with the necessary parameters to generate the embed URL.

Parameter Types

The screen embed feature allows you to configure cargo tracking views using the parameters below. You can enter the URL in a browser or embed it into an iframe to use the service.
 To track cargo, you must provide a valid user token along with at least one of the following: documentId, mblNo, bookingNo, or containerNo
Note
It is recommended to use the documentIdparameter, as it enables access to both current and historical shipment records.
Only shipments registered in your workspace can be tracked.
userToken (required)
A valid user token issued by SeaVantage
documentId (required)
Unique shipment identifier (UUID)
https://insight.seavantage.com/port?portId={documentId}&userToken={userToken}
Plain Text
복사
The documentId is returned in the response when a shipment is registered.
mblNo (optional)
Tracks cargo based on the registered Master B/L number.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&mblNo={mblNo}
Plain Text
복사
bookingNo (optional)
Tracks cargo based on the registered booking number.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&bookingNo={bookingNo}
Plain Text
복사
containerNo (optional)
Tracks cargo based on the registered container number.
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&containerNo={containerNo}
Plain Text
복사
hidePanel (optional)
If set to true, the timeline panel on the left will be collapsed by default when the page loads.

Example

To track using only a container number:
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&containerNo=MSMU5686991
Plain Text
복사
To track using a container number with hidePanel enabled:
https://insight.seavantage.com/cargo/tracking?userToken={userToken}&hidePanel=true&containerNo=MSMU5686991
Plain Text
복사