Container Tracking API

Track any shipment.
One endpoint.

Real-time container and bill of lading tracking across 170+ ocean carriers. Simple REST API, clean JSON responses, ready in minutes.

170+ carriers99.9% uptime<400ms avg response
GET /api/v1/container/:number
curl \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://traqocontainer.com/api/v1/container/MRSU6859427?sealine=MAEU"
200 OK
{
  "success": true,
  "data": {
    "reference_number": "MRSU6859427",
    "shipment_type": "Container",
    "sealine": "MAEU",
    "sealine_name": "Maersk",
    "status": "IN_TRANSIT",
    "origin": "Pithampur, India",
    "destination": "Nhava Sheva, India",
    "eta": "2026-06-18 00:00:00",
    "is_delayed": false,
    // ... events, vessels, containers & more
  }
}
Real-time tracking
Updated every few hours direct from carriers
170+ carriers
Maersk, MSC, CMA CGM, Hapag-Lloyd & more
Container & BL
Both reference formats supported
Full event timeline
Port-to-port history with transshipments
Vessel data
Vessel name, voyage & ETA included
Simple pricing
Pay per lookup or monthly — no hidden fees

Up and running in minutes

No complex setup, no SDKs required. Just an API key and standard HTTP requests.

01

Create a free account

Sign up with your email in under a minute. No credit card, no commitment.

02

Generate an API key

From your dashboard, create a key in one click. Revoke or rotate it anytime.

03

Start tracking

Send your first request and get structured JSON back — status, ETA, events, and more.

Everything you need to track ocean freight

Five focused endpoints covering containers, bills of lading, vessels, and sailing schedules.

Track a Container

Submit a container number and get full tracking data — status, route, ETA, port events, and vessel info.

GET/api/v1/container/:number

Track a Bill of Lading

Look up any Bill of Lading number to get the full shipment record — containers, route, milestones, and current status.

GET/api/v1/bl/:number

List Tracked Shipments

Retrieve all shipments saved on your account with summary status and ETA — useful for dashboards and bulk monitoring.

GET/api/v1/shipments

Vessel Location

Real-time AIS position for any vessel by IMO or MMSI. Returns coordinates, heading, speed, and destination port.

GET/api/v1/vessel/track

Sailing Schedules

Find all available sailings between two ports for a given date. Carrier, vessel, voyage number, and transit time included.

GET/api/v1/voyage/schedules

Built for every team

From solo developers to enterprise logistics teams, the Traqo API fits seamlessly into your workflow.

Freight Forwarders

Embed tracking into your TMS or customer portal. Give clients live shipment visibility without manual status calls.

E-commerce & Retail

Show customers where their goods are. Trigger notifications on milestone events like arrival at destination port.

Supply Chain Platforms

Add ocean freight tracking alongside air and road modes. One API for container and BL tracking across all major carriers.

ERP & WMS Integrations

Automatically update purchase order statuses in SAP, Oracle, or custom WMS when containers hit key milestones.

Analytics & BI Tools

Pull historical and live tracking data into your data warehouse. Analyse transit times, delays, and carrier performance.

Custom Dashboards

Build internal operations dashboards with live container maps, delay alerts, and carrier scorecards powered by our data.

Container Tracking API — FAQ

Everything developers ask before integrating the Traqo container tracking API.

What is the Traqo container tracking API?

It is a REST API that returns real-time container, bill of lading (BL) and vessel tracking data as clean JSON. You pass a container or BL number to a single endpoint and get the current status, full port/event timeline, route, ETA and vessel information — across 170+ ocean carriers, without scraping carrier websites.

How do I get an API key?

Create a free account, open the Developer section of your dashboard and generate a key. Requests authenticate with a Bearer token in the Authorization header — no SDK or approval process required.

Is there a free container tracking API?

Yes. The free tier includes API access so you can integrate and test end-to-end at no cost, and there are no per-call charges. The limit is your plan's monthly shipment allowance — how many new references you add in a billing cycle, not how many you may track at once. Shipments added in earlier cycles keep tracking for free until they are delivered, so you can have considerably more in transit at any moment than your monthly number. See pricing for higher tiers.

Which shipping lines and carriers are supported?

The API covers 170+ ocean carriers including Maersk, MSC, CMA CGM, Hapag-Lloyd, ONE, Evergreen, COSCO, ZIM and many regional lines — one endpoint and response shape for all of them.

Can I track by both container number and bill of lading?

Yes. There are dedicated endpoints for container numbers and for bill of lading (BL) numbers, and both return the same JSON structure, so your integration code stays identical.

How fresh is the tracking data and how fast is the API?

Data is pulled continuously from carrier and port sources, and the API responds in under ~400ms on average with 99.9% uptime, so it is suitable for real-time dashboards, TMS/ERP integrations and customer notifications.

What are the API rate limits?

120 requests per minute per API key by default, over a fixed 60-second window. Every response carries X-RateLimit-* headers, not just the ones that fail, so you can pace against the remaining count instead of waiting to be refused. Over the limit you get a 429 with Retry-After in seconds. Higher limits can be configured per plan.

The API returned 402. Does that mean my card failed?

Not necessarily — 402 has two distinct causes and data.error tells you which. "shipment_limit_reached" means you have used every shipment slot for the billing period; "payment_overdue" means a payment failed and the grace period has ended. Branch on data.error rather than the message text. Either way, references you already track keep updating; what is blocked is adding new ones.

Can I see my API usage without triggering an error?

Yes — the Developer page shows used, limit and remaining live, and the same figures are available to your integration. Poll that rather than learning your position from a 402.

I lost my API key. Can you resend it?

No — keys are stored hashed, so we genuinely cannot read an existing one back. Issue a new key and revoke the old one. That is a deliberate design choice: a key we could show you is a key anyone who reached our database could show themselves.

Can I connect Traqo to Zapier, Google Sheets or Slack?

Two integrations exist today and you can use them now. Webhooks push shipment events to any endpoint you own — set them up under Dashboard, Developer, Webhooks. The REST API gives you container, bill of lading and vessel tracking in your own tools, documented at /developer, and there is a SeaRates-compatible version of it at /developer/searates if you already use theirs. Both need developer mode switched on for your account. Zapier and Make, Google Sheets, Slack alerts, Microsoft Teams and an MCP server for Claude, ChatGPT and Cursor are not built. You can ask for them: open Settings, then Integrations, and press the button beside the one you want. That records your request and shows you how many other accounts have asked for the same thing, which is what decides the order we build them in. Nothing there is scheduled and we do not promise a date — if someone tells you one of these is coming soon, that is not something we have said. Anything not on that list can be requested from Dashboard, Feature requests, where you can also vote on what other customers have asked for.

Start building today

Get your API key in 60 seconds

Free tier included. No credit card required. Production-ready from day one.