Tracking

You can track more than one container at once using the Upload Excel or API Integration methods. You need to create a FREE account. You can use the API method with your 5 free credits. See full details about our API here. You can try the Upload Excel method when you upgrade your account after consuming 5 free credits; our dashboard guidelines will help you

You will receive notification e-mails containing: 

  • The name of the loading, discharging, and transshipment ports,
  • The name of the shipping line, the vessel names,
  • The dates of loading, discharging, and gate-out,
  • The total transit time,
  • Delay days of your shipment.

​These notification emails will also contain a link that will show you the actual live location of your container on a map.

After sending a tracking request, you will receive various notifications from ShipsGo to the e-mail addresses of your choice to keep you or your clients up-to-date about shipments. 

These notifications are; sailing notification, delay notifications, on-time arrival notice, container release alert, and container gate out confirmation.

Yes, you can track your container with Container Number, Booking Number, or Master BL Number. However, you need to have a ShipsGo account for this service. You can create it for free here.

Our Dashboard Guideline briefly explains how to track your shipments with Master BL Number.

Unfortunately, this happens sometimes because the shipping line tracking system is unavailable, or container number/ BL number information might be wrong. Please check and try again.

If a shipping line does not provide information about your shipment, the shipment is not trackable. So, we will send notification e-mails by labeling the container as “Untracked” which indicates that tracking this container is not possible. 

In this case, you should contact your carrier by phone or e-mail.


The First ETA (Estimated Time of Arrival) is the first planned arrival date our system obtained from the shipping lines’ database. The deviation between the first ETA and the Actual Arrival Date gives the number of days that the container arrived early or delayed.

Shipment Reference is your reference that you can enter any information and will help you understand which shipments you are working on.

You are free to use numbers, letters, or combinations of both. Type anything you want but please be sure that you are not exceeding 200 characters. 

Shipment Reference is also the title of your notification e-mails that you are going to receive from the ShipsGo system.

Some examples; Track1, Shipment35, ShipsGoTrack1875, 6756799, etc.


Yes. Thanks to our Live Map feature, you can see the vessel that your container is carried on. Using Live Map, you can access information about loading and discharging ports, the vessel's arrival date, the shipping line, and the vessel name. You can also integrate our Live Map to your website, and your clients can track their shipments directly through your website.

You can try our container tracking system with the five credits we give you free of charge after registration. You will have five free trial credits for tracking when you create your account. Once you consume your free credits, you will need to purchase more to continue using our tracking service.

Yes, ShipsGo tracks the refrigerated containers too. It's enough for the system that the user has the container number. As long as ShipsGo has the container number and the carrier gives the voyage data of it ShipsGo track refrigerated container as well

Most of the shipping lines formed their master bill of lading numbers as SCAC + master bill of lading number. If your bill of lading number does not follow this format it may be a house bill of lading number and not the master.

Unfortunately. Only master bill of lading, booking number, or container number are accepted for starting the tracking. 

The house bill of lading number is the seaway transportation documents’ number issued by freight forwarders for their clients. So no voyage data can be found when the triggers are made at the shipping line website when doing the query with the house bill of lading number.


ShipsGo provides container tracking support for 100+ shipping lines. You can see all the carriers we provide tracking support by clicking the link below.

The Carrier list is here 👈

You go to ShipsGo Homepage and select the Carrier of the Shipment. Then, enter your Container, Booking, or BL Number and click the Track Shipment button. You should Create an Account and Get Notification about your shipment easily!

Subscription

There is no time limit to your trial period. You will have 5 free trial credits for tracking when you create your account. Once you consume these, you will need to purchase more credits to continue using our tracking service.

Pricing

Some users are worried about their credits when they track with a Bill of Lading Number because most of the time B/L contains more than one container. 

Here is the rule: 1 tracking is equal to 1 credit. 

Please do not worry because regardless of how many containers your B/L has, when you track with a B/L number, only 1 credit will be consumed.

ShipsGo system works with credits. Every tracking request (uploading a shipment to ShipsGo once) consumes your 1 credit. Then, you will have unlimited queries for uploaded shipments, and it won't spend your credits.

You can track your shipment with the container number, the master bill of lading number(B/L), or the booking number. Regardless of how many containers your B/L has, when you track with a B/L number, only 1 credit will be consumed.

There is no expiration date for your credits. Cost per credit (CPC) changes according to the volume you purchase. Since you will get bonus credits as your purchasing volume increases, your CPC will decrease.

You can calculate your CPC and total cost by using our Calculator


Payment

You can use Visa and Master Cards and wire transfer methods for purchases from our system. It is a pre-paid service.

Please note that AMEX cards are not acceptable for now.

Please feel free to write to us from Live Chat or support@shipsgo.com if you need further assistance.

ShipsGo uses a 3D Secure system

3D Secure protects you against unauthorized online transactions as you will be required to enter a one-time password that will be sent to your mobile number and email address before you can complete the online transaction. 

This additional authorization step ensures that only you, as the cardholder, will have the password required to complete the transaction.

API

After creating your account, you are going to have an API key. You can reach it through your dashboard under the INTEGRATION section at the left sidebar. You can consider this key as a communication code between your company and ShipsGo. 

Thanks to this key, when the client sends the tracking request ShipsGo system recognizes the company name and stores the request to the company account. Then, our system sends the notification e-mail to you and your customers with your logo and e-mail address if you wish.

Besides, we use this Key to calculate the consumption of your credits as well.


No, there is no limitation for posting tracking requests; or making a call for getting voyage data. Your API calls limit is only restricted to the credit amount in your accounts. You can discover our API service here.

Of course, you can.

It is enough to create a GET function with API and add "&mapPoint=true" at the end of the request URL. Then you will see the vessel's coordinates.

There is no extra cost for API calls, integration, and technical support for API.

Our service works with credits. No matter if you track with a container number or BL number you need 1 credit for each track. This 1 credit includes all notifications, live map searches, and API calls until the end of the voyage. You can discover our API service here.

ShipsGo API provides the current situation of the shipment, so the historical data is not available for now. However, with ShipsGo Analytics, our users can reach comparative performative statistics according to their historical data combined with the ShipsGo database.

Tracking

Yes. Thanks to our Live Map feature, you can see the vessel that your container is carried on. Using Live Map, you can access information about loading and discharging ports, the vessel's arrival date, the shipping line, and the vessel name. You can also integrate our Live Map to your website, and your clients can track their shipments directly through your website.

You can try our container tracking system with the five credits we give you free of charge after registration. You will have five free trial credits for tracking when you create your account. Once you consume your free credits, you will need to purchase more to continue using our tracking service.

Yes, ShipsGo tracks the refrigerated containers too. It's enough for the system that the user has the container number. As long as ShipsGo has the container number and the carrier gives the voyage data of it ShipsGo track refrigerated container as well

Most of the shipping lines formed their master bill of lading numbers as SCAC + master bill of lading number. If your bill of lading number does not follow this format it may be a house bill of lading number and not the master.

Unfortunately. Only master bill of lading, booking number, or container number are accepted for starting the tracking. 

The house bill of lading number is the seaway transportation documents’ number issued by freight forwarders for their clients. So no voyage data can be found when the triggers are made at the shipping line website when doing the query with the house bill of lading number.

ShipsGo provides container tracking support for 100+ shipping lines. You can see all the carriers we provide tracking support by clicking the link below.

The Carrier list is here 👈

Shipment Reference is your reference that you can enter any information and will help you understand which shipments you are working on.

You are free to use numbers, letters, or combinations of both. Type anything you want but please be sure that you are not exceeding 200 characters. 

Shipment Reference is also the title of your notification e-mails that you are going to receive from the ShipsGo system.

Some examples; Track1, Shipment35, ShipsGoTrack1875, 6756799, etc.


You go to ShipsGo Homepage and select the Carrier of the Shipment. Then, enter your Container, Booking, or BL Number and click the Track Shipment button. You should Create an Account and Get Notification about your shipment easily!

You can track more than one container at once using the Upload Excel or API Integration methods. You need to create a FREE account. You can use the API method with your 5 free credits. See full details about our API here. You can try the Upload Excel method when you upgrade your account after consuming 5 free credits; our dashboard guidelines will help you

You will receive notification e-mails containing: 

  • The name of the loading, discharging, and transshipment ports,
  • The name of the shipping line, the vessel names,
  • The dates of loading, discharging, and gate-out,
  • The total transit time,
  • Delay days of your shipment.

​These notification emails will also contain a link that will show you the actual live location of your container on a map.


After sending a tracking request, you will receive various notifications from ShipsGo to the e-mail addresses of your choice to keep you or your clients up-to-date about shipments. 

These notifications are; sailing notification, delay notifications, on-time arrival notice, container release alert, and container gate out confirmation.


Yes, you can track your container with Container Number, Booking Number, or Master BL Number. However, you need to have a ShipsGo account for this service. You can create it for free here.

Our Dashboard Guideline briefly explains how to track your shipments with Master BL Number.


Unfortunately, this happens sometimes because the shipping line tracking system is unavailable, or container number/ BL number information might be wrong. Please check and try again.

If a shipping line does not provide information about your shipment, the shipment is not trackable. So, we will send notification e-mails by labeling the container as “Untracked” which indicates that tracking this container is not possible. 

In this case, you should contact your carrier by phone or e-mail.


The First ETA (Estimated Time of Arrival) is the first planned arrival date our system obtained from the shipping lines’ database. The deviation between the first ETA and the Actual Arrival Date gives the number of days that the container arrived early or delayed.

Payment

ShipsGo uses a 3D Secure system. 

3D Secure protects you against unauthorized online transactions as you will be required to enter a one-time password that will be sent to your mobile number and email address before you can complete the online transaction. 

This additional authorization step ensures that only you, as the cardholder, will have the password required to complete the transaction.


You can use Visa and Master Cards and wire transfer methods for purchases from our system. It is a pre-paid service.

Please note that AMEX cards are not acceptable for now.

Please feel free to write to us from Live Chat or support@shipsgo.com if you need further assistance.


API

After creating your account, you are going to have an API key. You can reach it through your dashboard under the INTEGRATION section at the left sidebar. You can consider this key as a communication code between your company and ShipsGo. 

Thanks to this key, when the client sends the tracking request ShipsGo system recognizes the company name and stores the request to the company account. Then, our system sends the notification e-mail to you and your customers with your logo and e-mail address if you wish.

Besides, we use this Key to calculate the consumption of your credits as well.


No, there is no limitation for posting tracking requests; or making a call for getting voyage data. Your API calls limit is only restricted to the credit amount in your accounts. You can discover our API service here.

Of course, you can.

It is enough to create a GET function with API and add "&mapPoint=true" at the end of the request URL. Then you will see the vessel's coordinates.


There is no extra cost for API calls, integration, and technical support for API.

Our service works with credits. No matter if you track with a container number or BL number you need 1 credit for each track. This 1 credit includes all notifications, live map searches, and API calls until the end of the voyage. You can discover our API service here.

ShipsGo API provides the current situation of the shipment, so the historical data is not available for now. However, with ShipsGo Analytics, our users can reach comparative performative statistics according to their historical data combined with the ShipsGo database.

API_DOC

The data of the voyage is updated 3 times in a day. So, you can set your GET function to be triggered 3 times a day.

Please note that:

Any interaction with the API will always require your API KEY. It will be available on your dashboard when you have an account 

Our API documentation can provide more detailed information on creating a new request.

The ShipsGo API has 2 methods: Post and Get.

Since some information such as {containerNumber}, {blContainersRef} , {emailAddress} etc. are needed to start tracking, the first step is to create the tracking request. The tracking request is created by using the Post Method with the container, master bill of lading, or booking number.

The {requestId} returns with the 200 OK Status Code to the clients if the request was created and posted to the ShipsGo successfully and that means the request reached the server.

If the POST fails, the Error Message returns. The list of the error responses for the method may be found here.

The client can run the GET method to call voyage data by using the {containerNumber} or {requestId} after the success message returned 

Please keep in mind that the POST method is idempotent. It's enough to run POST for each track for once. However, the client can make GET calls as much as is needed. 

TIP:

  • Since each shipment is updated 3 times a day for each shipment 3 GET calls are highly enough. 

Caution:

  • The ShipsGo API provides data sourced from a container's active or most recent journey. 
  • House bill of lading tracking is not supported. Only the master bill of lading number is accepted.
  • It's enough to run POST for each track for once.


No, Since ShipsGo is gathering publicly available information, the authorization letter is not necessary. You are able to track your shipment any time as soon as your shipping line is one of the supported shipping lines and you have an API key.

Yes, we provide API. You can find all the details about API here.

If you need technical support or more information related to API integration, please feel free to write to us from Live Chat or support@shipsgo.com


After creating your account, you are going to have an API key. You can reach it through your dashboard under the INTEGRATION section at the left sidebar. You can consider this key as a communication code between your company and ShipsGo. 

Thanks to this key, when the client sends the tracking request ShipsGo system recognizes the company name and stores the request to the company account. Then, our system sends the notification e-mail to you and your customers with your logo and e-mail address if you wish.

Besides, we use this Key to calculate the consumption of your credits as well.


No, there is no limitation for posting tracking requests; or making a call for getting voyage data. Your API calls limit is only restricted to the credit amount in your accounts. Your credits will only be consumed when you POST the shipment to the system. You do not pay for GET voyage data, i.e., for multiple API calls.

Of course, you can.

It is enough to create a GET function with API and add "&mapPoint=true" at the end of the request URL. Then you will see that a new window will be opened showing the vessel's position on a live map.

When you use the API integration, you get voyage information in an XML or JSON format. One of the first things you’ll see in the XML OR JSON file is the "status." This "status" indicates the condition of the shipments.

The meanings of the statuses are as follows;

  • InProgress (StatusId = 20): The shipping line hasn't released any information about the container yet.
  • Booked (StatusId = 30): The shipping line has shared the voyage information about this shipment. It's not sailed yet.
  • Loaded (StatusId = 35): The shipment is loaded on the vessel but the vessel is not sailed from POL yet.
  • Sailing (StatusId = 40): The container is on the way.
  • Arrived (StatusId = 45): The Vessel arrived at POD but The shipment is waiting to be discharged
  • Discharged (StatusId = 50): The container was discharged at the discharge port.
  • Untracked (StatusId = 60): It is not possible to track the container because the shipping line responsible for carrying the container has no online tracking service.


After your tracking request reaches us, our system checks the carrier website to fill out the XML form. 

1. If your system calls the data before the system collects the data from the carrier's website, you can have an empty data response. Most probably, at the second call attempt, you will have the data.             

2. If the carrier doesn't provide the voyage data yet, the XML response will simply be empty. However, our system checks the carrier website 3 times a day and gets the data when it is ready. What you should do is to set your GET call to run 3 times a day, and at the end of the day, you will have all data available. The status of this kind of data is "in progress".                 

3. Sometimes, however, the shipments are not trackable at all. This kind of shipment's status is "untracked". The shipment can be untrackable if the shipping line has no tracking system at all or the container number can’t be assigned to any shipping line.     

XML Full Data Example: https://drive.google.com/file/d/1_yHhrFHOMcBBjGUgWgAH53oxGoiNEZze/view?usp=sharing

JSON Full Data Example: https://drive.google.com/file/d/167S4Ljoo_Op8u3J5k74c-_5In2hGUbOt/view?usp=sharing

Unfortunately, our current API allows you to query each shipment separately.

In order to get data from ShipsGo, initially, you should send data to our system by using the POST function of our API. After the post, your request should reach us successfully. Then you can pull the voyage data by the GET method of the API. 

If your data reaches us successfully, then a Request ID returns as a response. These IDs are unique for every tracking request of yours, and it differs from shipment to shipment. The most important function of this ID is that when you get this ID, you will already be sure that your POST has successfully reached us. It is a confirmation message from ShipsGo, so to speak. 

Example of Successful Response ID 1-534567 

However, your POST failed if you get the following responses instead of request-id. You need to correct the data according to the explanations and post the request again.

Response: "The Field (Code) Value (test1234) is not in a valid format"

  • Container number must consist of 11 characters: 4 letters followed By 7 Numbers EX. AAAA1234567

Response: "The Field (Code) Value (EGHU9483781) is not valid"

  • The container number format is true however the number is not valid. It would be EGHU948378-8 due to the rules of container number creation

Response: "The shipping line field is required"

  • You need to enter the name of the shipping line according to the ShipsGo Shipping Line List

Response: "The Entered Value (support@gmaıl.com) In Field (Email) Is Not A Valid Email Address"

  • You typed the email address wrongly. Please control the typing

Response: "No Active Subscription Or It Is Expire"

  • Probably your credits ran out or your account was inactive because of some other reason. Please contact with ShipsGo team when it’s happened

After you have completed the POST successfully you can run the GET method by following the rules. You may encounter some error messages while running the GET. Here are they and their meaning:

Error Message: "Invalid Authentication Code"

  • You are using an invalid API KEY or your account is prohibited to use the API connection 

Error Message: "No Active Subscription Or It Is Expire"

  • Probably your credits ran out or your account was inactive because of some other reason.

Error Message: "There Are No Data Related To Requested Id"

  • You are entering the wrong container number/request ıd. Or you try to get the container data of which you haven't POST the tracking request to us




You can find all the details about milestones here.


No. The only thing you need to do is send the BL number. The system is going to trigger the containers under the BL with the voyage data and make it ready in XML/JSON.


Every shipment is updated every 8 hours after creation time so the update time differs from shipment to shipment according to creation time. However, you can set your GET function 3 times a day morning, noon and night. So at the end of the day, you will have all updates for your all shipments

When you Post the shipment to ShipsGo you get a Request ID if the POST is successful. After you get the Request ID you can make a call immediately. You will have an answer. However, the data may not be available at that moment and the XML file may be null because data availability is up to the carrier. If the data is available at the carrier website the average response time is in second.

If you want to deactivate the movements window on the Live Map solution that you are

using on your websites, you can use the below codes.

<iframe

src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?movements=hide"

id="IframeShipsgoLiveMap"

style="height: 550px;width: 100%;"></iframe>

<script>

if (window.addEventListener)

window.addEventListener("message", ShipsgoMessagesListener);

function ShipsgoMessagesListener() {

if (event.data.Action === "LoadNewContainerCode")

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

event.data.Parameters.ContainerCode + '?movements=hide';

}

var urlParams = new URLSearchParams(window.location.search);

var defaultQuery = urlParams.get('query');

if (defaultQuery === undefined || defaultQuery === null)

defaultQuery = "default-container-code";

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

defaultQuery + '?movements=hide';

</script>

Important Note: If you want to hide both the search bar and the movements window, you

can do it as well; simply apply both solutions to your code.

If you want to deactivate the movements window and the search bar that are on the Live

Map solution that you are using on your websites, you can use the below codes.

<iframe

src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?movements=hide&tags

=hide-search-box" id="IframeShipsgoLiveMap"

style="height: 550px;width: 100%;"></iframe>

<script>

if (window.addEventListener)

window.addEventListener("message", ShipsgoMessagesListener);

function ShipsgoMessagesListener() {

if (event.data.Action === "LoadNewContainerCode")

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

event.data.Parameters.ContainerCode +

'?movements=hide&tags=hide-search-box';

}

var urlParams = new URLSearchParams(window.location.search);

var defaultQuery = urlParams.get('query');

if (defaultQuery === undefined || defaultQuery === null)

defaultQuery = "default-container-code";

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

defaultQuery + '?movements=hide&tags=hide-search-box';

</script>

If you want to deactivate the search bar on the Live Map solution that you are using on your websites, you can use the below iframe codes.

<iframe

src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?tags=hide-search-box"

id="IframeShipsgoLiveMap"

style="height: 550px;width: 100%;"></iframe>

<script>

if (window.addEventListener)

window.addEventListener("message", ShipsgoMessagesListener);

function ShipsgoMessagesListener() {

if (event.data.Action === "LoadNewContainerCode")

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

event.data.Parameters.ContainerCode + '?tags=hide-search-box';

}

var urlParams = new URLSearchParams(window.location.search);

var defaultQuery = urlParams.get('query');

if (defaultQuery === undefined || defaultQuery === null)

defaultQuery = "default-container-code";

document.getElementById("IframeShipsgoLiveMap").src =

"http://shipsgo.com/iframe/where-is-my-container/" +

defaultQuery + '?tags=hide-search-box';

</script>

Important Note: If you want to hide both the search bar and the movements window, you

can do it as well; simply apply both solutions to your code.