Qubictron Developer Documentation and API Reference
Track ocean and air cargo, calculate container loads and connect real-time shipment data directly to your ERP, CRM, TMS, website or AI agent.
Integrated with 200+ carriers worldwide
APIs
REST over HTTPS, JSON responses, API key in the x-api-key header. Every API ships with an OpenAPI specification.
Container Tracking API
Multi-carrier ocean freight tracking. One request returns the current status and full event history of a shipment from any supported ocean carrier.
- Inputs
- Container number, Bill of Lading (B/L) number or booking number; optional carrier SCAC.
- Outputs
- Shipment status, carrier, ports and terminals, route with transshipments, vessels and voyages, container events with timestamps and locations.
- Endpoint
GET /tracking/v1/ocean
Air Cargo Tracking API
Air waybill tracking across supported airlines with milestone and event history for the shipment.
- Inputs
- Air Waybill (AWB) number.
- Outputs
- Shipment status, airline, routing, flight milestones and event history.
- Endpoint
GET /tracking/v1/air
Load Calculator API
Container load planning: calculates how a set of cargo items fits into containers.
- Inputs
- Cargo items with dimensions, weights and quantities; container types.
- Outputs
- Packing result: container selection, item placement and utilization.
- Endpoint
POST /load-calculator/v2/pack
What can an AI agent do with Qubictron?
Any assistant or agent that can call an HTTP API can answer shipment questions with Qubictron data today. A dedicated MCP server is in development.
“Where is container MSCU1234567?”
- Request
GET /tracking/v1/ocean?reference_number=MSCU1234567&reference_type=container- Returns
- Shipment status, latest container event with location and timestamp, current vessel and voyage, route with ETA at the port of discharge.
“Track AWB 176-12345678.”
- Request
GET /tracking/v1/air?awb_number=176-12345678- Returns
- Shipment status, airline, routing and flight milestones with actual and estimated times.
FAQ
6 questions01What is a Container Tracking API?
An HTTP API that returns the status and event history of an ocean shipment from the carrier’s data, so you can show or process tracking inside your own software instead of checking carrier websites. Qubictron aggregates 200+ ocean carriers behind one endpoint and one response format.
02Can I track a container by Bill of Lading or booking number?
Yes. reference_type accepts bl, booking or container. Support per reference type varies by carrier. See the list of carriers.
03Which ocean carriers does Qubictron support?
Maersk, MSC, CMA CGM, COSCO, Hapag-Lloyd, ONE, Evergreen, ZIM, Yang Ming, OOCL and 200+ others, including regional and niche lines. The full list with supported reference types is on the List of Carriers page and via GET /tracking/v1/ocean/carriers.
04Can I integrate Qubictron with SAP, ERP, CRM or TMS systems?
Yes. The APIs are plain REST over HTTPS with JSON responses and API key authentication, so they work with any system that can make HTTP requests. An OpenAPI specification is provided for client generation.
05What happens when a carrier is temporarily unavailable?
The API responds with HTTP 200 and a descriptive status_code such as CARRIER_TEMPORARILY_DISABLED, CARRIER_UNDER_MAINTENANCE or CARRIER_NO_RESPONSE, so your integration can retry later. See HTTP Response Codes.
06What are the rate limits?
100 requests per 20 seconds per organization. Exceeding it returns API_KEY_RATE_LIMIT_EXCEEDED and access pauses for one minute. Details on the Rate limit page.