What Happens After I Add A Shipment to Terminal49? (Recently Added Shipments)

Last updated: April 16, 2026

When you add shipments to Terminal49 via - Dashboard, email uploads, or API you can see them all in All Tracking Requests Tab.

From there, you can filter tracking requests by status (Created, Failed, Pending, Awaiting Manifest), or search using the Bill of Lading, reference number, container number, or shipping line to view their upload progress.

image.png

Video Walkthrough:


What does each status mean?

  • Created: Terminal49 is now successfully tracking your shipment and you can find it under All Shipments.

  • Pending: Terminal49 is still working on locating your shipment. Most shipments are in Pending status for only a few seconds or minutes, but can sometimes stay here for up to 24 hours while we communicate with the steamship line. No further action is needed on your part.

  • Awaiting Manifest: The carrier has a record of your Master Bill of Lading (MBoL) but data is not yet available, or the requested booking number could not be found. Your shipment will be created on Terminal49 automatically once the shipping line assigns container numbers to the shipment and reported at least one milestone such as 'empty out'. No further action is needed on your part. If your request number cannot be found after 7 days we will mark the tracking request as failed.​

  • Failed: These are shipments that Terminal49 cannot track. Different reasons for failure are detailed below. These are shipments you should investigate internally and try again once you have updated information. ​

    Note: Should you wish to adjust the duration before marking your tracking requests as failed, please contact us through support@terminal49.com.


Why did my shipment fail to track?

  • Not Found: if the Master Bill of Lading or Booking number you provided does not exist with the carrier, we either immediately fail the tracking request or keep trying depending on whether the request number type is a bill of lading or a booking number:

    • Booking numbers and Bill of lading numbers do not fail instantly. We change the status to awaiting manifest and will keep checking your request daily. If your request number cannot be found after 7 days, we will mark the tracking request as failed by changing the status to failed.

      Possible reasons the tracking request number was not found with the carrier:

      • Incorrect Carrier Name - though the shipping line data gets automatically updated after adding Bill of Lading (BOL)/Booking number, sometimes accidental edit might happen. You'll need to create a new tracking request with the correct SCAC.

      • Incorrect Request Number Type Selected - you selected the wrong request number type when adding the shipment (e.g., selected "booking number" when the number is actually a "bill of lading", or vice versa). You'll need to create a new tracking request with the correct request number type.

        Selecting request number type via Quick Entry:

        image.png

        Requesting request number type via Bulk Import:

      • Unsupported Request Number Types - the request number type provided is currently unsupported. See below the list of unsupported request number types:

        • House Bill of Lading Number (HBL)

        • Purchase Order Number (PO)

        • Seal Number

        • Invoice Number

        • Packing List Number

        • Sales Order Number

      • Typo in the shipment number - your customer provided the wrong number or an accidental edit happened during the shipment upload.

  • Retries Exhausted: If we are having difficulty connecting to the shipping line, or if we are unable to parse the response from the shipping line, we will keep retrying up to 14 times with an exponential back off. This process can take up to approximately 24 hours.If you would like to try this Master Bill of Lading or Booking number again, you will need to upload it again or send a new tracking request. Typically this occurs within 14 hours although it may take longer in some circumstances.

  • Shipping Line Not Supported: Terminal49 is not currently integrated with the carrier responsible for that shipment. To request support for additional carriers, please provide estimated annual container volume and 3-6 samples of tracking numbers (Bill of lading/booking numbers/container numbers

  • Shipping Line Unreachable: this means the shipping line was unreachable at the time of the tracking request submission. This is a temporary failure reason; you should retry the tracking request.

  • Duplicate: when the shipment already existed. Please note: You can't submit the same Bill of Lading (BL) twice, the same booking number twice, or track an existing single container using BL/Booking number if the container is already being tracked using a container number. If you receive a duplicate error but cannot find the existing shipment in your view, search for the container number directly in the All Shipments tab or global search - the container may already be tracked under a different reference number (such as a bill of lading or booking number). However, if you track the same container in different ways - ex. once via Master Bill of Lading (MBL) and once via booking# - then we'll treat that as two containers and you'd be charged for the resulting containers twice.

  • Expired: this means your request number still cannot be found on the steamship line's website after 7 days.

  • Booking cancelled: if the shipping line indicates that the booking has been cancelled.

  • Invalid Number: if the shipping line rejects the formatting of the number.

  • Data Unavailable: It means the number is acknowledged as valid by the shipping line, but they will not return any data.


Resubmitting tracking requests

When a shipment fails, you click Resubmit to try it again. This is worth trying if it failed because retries were exhausted or the shipping line was previously unreachable.

image.png

When Was My Tracking Request Last Refreshed?

For tracking requests with a 'failed' or 'awaiting manifest' status, you'll be able to see when Terminal49 last checked the data for your shipment with the steamship line.

image.png

If you are creating tracking requests via API, this page has more helpful information.

If you need help with troubleshooting tracking requests or have any other questions, the fastest way to get assistance is through our in-app chat. You can also reach us at support@terminal49.com and include the shipment number (bill of lading/booking number/contaner number) in question.