--- source_url: "https://www.gocargotrack.com/developers?utm_source=openai" title: "Developers — API & Webhooks | Go Cargo Track" mirrored_at: 2026-08-30T13:01:40.786Z host: www.gocargotrack.com cited_in_42a: true mirror_canonical: "https://index.42a.ai/www.gocargotrack.com/developers__q__utm_source_openai" --- > **Original source:** https://www.gocargotrack.com/developers?utm_source=openai Developer Platform · v1 ## Ship the world. From your code. The Go Cargo Track REST API gives you real-time container tracking, shipment management, port intelligence, weather, CO₂ calculations and webhooks — over a single, signed, rate-limited endpoint. curl · Track a container \# Track an MSC container in < 200ms curl https://api.gocargotrack.com/api/v1/track \\ -H "Authorization: Bearer gct\_live\_••••••••••••" \\ -H "Content-Type: application/json" \\ -d '{"trackingNumber":"MSCU1234567","carrier":"MSC"}' 77+ Endpoints 99.95% Target Uptime <200ms P95 Latency 12+ Webhook Events 3 Official SDKs ## Build with Go Cargo Track Everything our own dashboard runs on, exposed as a versioned, scoped REST API. ### Tracking & Visibility Ocean and air tracking across 200+ carriers. Live vessel positions, ETAs, milestones and proof of delivery. POST /trackGET /shipments/{id}/eventsGET /vessels ### Shipments & Documents Create ocean & air shipments, attach BL/AWB documents, manage detention & demurrage workflows. POST /create-shipmentPOST /create-air-shipmentGET /shipments/all ### Credits & Billing Read live balance, top up credits, list invoices and trigger Windcave or M-PAiSA payments. GET /credits/balancePOST /credits/topupGET /invoices ### Intelligence Port congestion, weather along route, CO₂ emissions and carrier reliability KPIs — turn-key analytics. GET /port-intelligence/{port}GET /weather/port/{unlocode}POST /emissions/calculate ### Webhooks Subscribe to shipment events. Signed deliveries, automatic retries, and a replay log — all visible in the portal. shipment.createdshipment.eta\_updatedcredits.low\_balance ### Built-in Safety OAuth-style scopes, per-key rate limits, CORS allowlists, sandbox keys, full audit trail of every API call. scopesX-RateLimit-\*HMAC-SHA256 ## Quick start Generate a key in the dashboard, pick your language, and ship your first call. curl https://api.gocargotrack.com/api/v1/track \\ -H "Authorization: Bearer $GCT\_API\_KEY" \\ -H "Content-Type: application/json" \\ -d '{"trackingNumber":"MSCU1234567","carrier":"MSC"}' import { GoCargoTrack } from "@gocargotrack/sdk"; const gct = new GoCargoTrack(process.env.GCT\_API\_KEY); const result = await gct.track({ trackingNumber: "MSCU1234567", carrier: "MSC", }); console.log(result.status, result.eta); from gocargotrack import Client gct = Client(api\_key=os.environ\["GCT\_API\_KEY"\]) result = gct.track(tracking\_number="MSCU1234567", carrier="MSC") print(result.status, result.eta) track(\[ 'trackingNumber' => 'MSCU1234567', 'carrier' => 'MSC', \]); echo $result->status; ## Endpoint reference (preview) A taste of what's available. [See the full reference →](https://www.gocargotrack.com/developers/reference) Tracking POST/api/v1/trackTrack a container or BL GET/api/v1/shipments/{id}/eventsGet tracking events for a shipment GET/api/v1/vessels/{imo}Live AIS vessel position Shipments GET/api/v1/shipments/allList all shipments POST/api/v1/create-shipmentCreate an ocean shipment POST/api/v1/create-air-shipmentCreate an air (AWB) shipment Credits GET/api/v1/credits/balanceGet current credit balance GET/api/v1/credits/historyList credit transactions Intelligence POST/api/v1/emissions/calculateCalculate route CO₂ GET/api/v1/weather/port/{unlocode}Weather for a port GET/api/v1/port-intelligence/{unlocode}Port congestion & KPIs ## Webhooks that just work HMAC-signed deliveries with automatic retries (1m, 5m, 30m, 2h, 12h) and a full replay log. #### Available events - shipment.createdA new shipment is added - shipment.status\_changedin\_transit, arrived, delivered… - shipment.eta\_updatedCarrier revised the ETA - shipment.deliveredFinal delivery confirmation - container.dischargedContainer off the vessel - container.gate\_outContainer left the terminal - credits.low\_balanceBalance below your threshold - webhook.testManual test from the portal #### Verify a signature (Node) import crypto from "crypto"; function verify(req, secret) { const sig = req.headers\["x-gct-signature"\]; // t=...,v1=... const \[t, v1\] = sig.split(",").map(p => p.split("=")\[1\]); const expected = crypto .createHmac("sha256", secret) .update(\`${t}.${req.rawBody}\`) .digest("hex"); return crypto.timingSafeEqual( Buffer.from(expected), Buffer.from(v1) ); } ### Sandbox mode Use a **gct\_test\_\*** key against the sandbox URL to call every endpoint with deterministic mock data — no credits consumed. `https://api.gocargotrack.com/api/v1/sandbox` [Generate test key](https://www.gocargotrack.com/signup) ## Official SDKs Idiomatic clients with typed responses, retries and built-in webhook helpers. ### Node.js / TypeScript npm i @gocargotrack/sdk v1.0.0ESM + CJS ### Python pip install gocargotrack v1.0.03.9+ ### PHP composer require gocargotrack/sdk v1.0.08.1+ ## API pricing Start free. Scale when you ship. Free ### Sandbox $0/mo - 1,000 requests / mo - Test keys only - All endpoints - Community support [Start free](https://www.gocargotrack.com/signup) Starter ### Starter $49/mo - 50,000 requests / mo - Live + test keys - 120 req/min - Email support [Choose Starter](https://www.gocargotrack.com/signup) Most popular ### Growth $199/mo - 500,000 requests / mo - 600 req/min - Webhooks & replay - Priority email + chat [Choose Growth](https://www.gocargotrack.com/signup) Scale ### Scale $799/mo - 5M requests / mo - 2,400 req/min - 99.95% SLA - Dedicated CSM [Choose Scale](https://www.gocargotrack.com/signup) Enterprise ### Enterprise Custom - Unlimited volume - Custom rate limits - Private deployment - 24/7 phone support [Talk to sales](#apply) ## Apply for API access Tell us about your use case. We'll be in touch within 2 business days.