Cargo Tracking API Guide
Cargo tracking teams usually need one reliable workflow for ocean and air shipments. TrackCargo supports public tracking pages for container, Master Bill of Lading (MBL), and Air Waybill (AWB) references, plus account workflows for dashboards, API keys, bulk order creation, and webhook configuration.
Start with supported shipment references
A useful tracking API should match the references operations teams already receive from carriers and forwarders. In TrackCargo, users can initiate tracking for sea shipments by container, booking, or MBL reference, and for air shipments by AWB. The public app also exposes supported shipping-line and airline lists so teams can check coverage before building a workflow around a carrier.
- Ocean workflows: container, booking, and Master Bill of Lading references.
- Air workflows: Air Waybill numbers with airline prefix support.
- Carrier resources in this project include 80+ supported ocean and air carrier resources.
Check the API shape before committing
TrackCargo documents REST endpoints for creating client orders, initiating sea and air tracking, creating bulk tracking orders, listing recent orders, retrieving order tracking data, and assigning carriers. The developer page also lists public carrier endpoints for active airlines and active shipping lines.
Useful checks: confirm whether the API supports the references you use, whether bulk creation is available, how tracking data is retrieved, and whether account workflows can be connected through API keys and webhooks.
Build a practical test matrix
A serious evaluation should include the references that create real support work, not only clean examples. For TrackCargo, that means testing a container number, a Master Bill of Lading, a booking reference, and an AWB where your team already knows the expected carrier. Include one shipment that is early in its lifecycle and one that has already completed, because those two cases reveal different product behavior.
- Record the submitted reference, selected or inferred carrier, created order, latest status, and returned event history.
- Check whether dashboard users can understand the same shipment that API users retrieve programmatically.
- Confirm how failed, invalid, cancelled, deleted, or not-yet-available shipments appear to operations staff.
- Review whether the payload carries enough context for your TMS, ERP, customer portal, or support workflow.
Prove the workflow with a small, real payload
The best API evaluation uses live examples from your operation, not a perfect test shipment. Pick a few recent ocean references, a few AWBs, and at least one shipment where the carrier data is incomplete. That mix shows whether the platform handles the normal case, the messy case, and the "not available yet" case without forcing your team back into spreadsheets.
For developers, that pilot should prove three things: the create flow is easy to automate, the retrieved tracking payload is predictable enough to store, and downstream systems can react through alerts or webhooks without losing the raw carrier context.
Understand update timing and data ownership
Shipment status depends on carrier data availability. TrackCargo presents carrier-sourced milestones, status, routing, vessel schedule, flight, and ETA details where those fields are returned. This is a better promise than claiming universal live tracking, because actual update timing varies by carrier and shipment mode.
When evaluating any tracking provider, look for clear wording about data source, refresh behavior, unsupported carriers, failed carrier detection, and inconclusive shipment states.
Map product capabilities to team workflows
TrackCargo supports quick public lookups and account-based workflows. A logistics team can use public tracking for ad hoc checks, then move into dashboard, API, and webhook workflows when it needs higher tracking volume or integration with internal systems.
- Trial plan: 5 free trackings for 1 month.
- Pro plan: 20 included trackings, API access, webhook notifications, and $1 per additional tracking in the current pricing copy.
- Developer workflows: REST API, API keys, bulk tracking endpoints, carrier list endpoints, and webhook support.
Decide what will own the shipment record
Before writing integration code, decide whether TrackCargo is only the tracking source or also part of the team workspace. If your internal system remains the source of truth, store the TrackCargo order ID beside the internal shipment, PO, or customer reference. If operations users work inside TrackCargo, make sure the same order carries the documents, parties, SKU details, custom fields, and last-free-day follow-up that the team needs to act on a milestone.
This decision prevents a common failure mode: the API returns useful tracking data, but the person handling the exception still has to open email, spreadsheets, and the carrier portal to decide what to do. A good API evaluation therefore includes both the technical payload and the human handoff around it.
Use a short evaluation checklist
- Can the platform track the exact reference types your team handles?
- Can users verify supported carriers before submitting shipments?
- Does the API cover create, bulk create, retrieve, cancel, and carrier assignment workflows?
- Are dashboards available for non-developer users?
- Can the account configure webhook delivery for downstream systems?
- Does the provider avoid promising update speeds that carrier data cannot support?
Related TrackCargo guides
If you are comparing API vendors, read the container tracking API guide next, then review DCSA events for ocean milestone language and AWB tracking for air cargo workflows.
Where TrackCargo fits
TrackCargo is positioned as a practical tracking platform for sea and air cargo teams: public tracking pages for quick lookups, authenticated dashboards for shipment visibility, carrier list pages for coverage checks, and REST API plus webhook workflows for integration.