CargoWise API
CargoWise is WiseTech Global's unified logistics execution platform that centralizes freight forwarding, customs and compliance, warehousing, and transport on a single system used by thousands of forwarders, brokers, and carriers worldwide. An unofficial API lets you programmatically pull shipments, customs declarations, invoices, warehouse orders, and tracking events—and push updates like new bookings, customs entries, and consignment status back into CargoWise.
What is CargoWise?
CargoWise, a WiseTech Global product, is a unified logistics execution platform that centralizes global supply chain operations across international freight forwarding, customs and compliance, warehousing, and transport on a single intelligent system. Used by thousands of organizations—including freight forwarders, customs brokers, warehouse operators, carriers, and drayage operators—CargoWise runs capacity planning, vessel and trucking bookings, border compliance, inventory tracking, order-to-cash automation, and real-time shipment visibility through its CargoWise Neo portal.
Core product areas include:
- International Freight Forwarding (air, ocean, road & rail)
- Customs & Compliance (declarations, border and government filings)
- Warehouse Management (product, transit, and bonded warehouses)
- Transport & Landside Solutions and Parcel (B2B and B2C final-mile)
- International eCommerce and Carrier Connectivity
- Enterprise Tools (Accounting, CRM, HR Manager, Workflow & Productivity, eDocs) and CargoWise Neo visibility portal
Common data entities:
- Shipments, Consignments, Bookings, Bills of Lading
- Customs Declarations, Border Filings, Compliance Records
- Invoices, Accruals, Disbursements (invoice-to-cash)
- Warehouse Orders, Inventory, Inbound/Outbound Movements
- Tracking Events, Milestones, Container and Vessel Status
- Organizations, Carriers, Customers, eDocs and Attachments
The CargoWise Integration Challenge
Logistics teams run mission-critical operations on CargoWise daily, but turning its execution workflows into API-driven automation is non-trivial:
- eAdapter and message-based integration: Much of CargoWise's connectivity flows through its eAdapter XML messaging layer, which requires careful schema mapping and event subscription rather than simple REST reads
- OAuth 2.0 app registration: REST API access requires registering an application, obtaining a client ID and secret, and managing token lifecycles per tenant
- Multi-module spread: Forwarding, Customs, Warehouse, and Transport each carry their own object models, IDs, and lifecycle states that must be reconciled
- Per-tenant configuration: Branch structures, workflows, document templates, and registry settings are tailored per organization—generic integrations break across tenants
- Government and carrier gateways: Customs declarations and carrier connectivity route through external systems with their own filing windows, statuses, and acknowledgements
- Document and eDocs workflows: Bills of lading, customs paperwork, and proof-of-delivery require careful upload/download and template handling
How Supergood Creates CargoWise APIs
Supergood reverse-engineers authenticated browser flows, CargoWise's REST API, and eAdapter messaging to deliver a resilient API layer for your CargoWise tenant—across Forwarding, Customs, Warehouse, and Transport modules.
- Handles OAuth 2.0 app registration, username/password, and MFA securely in a managed session
- Maintains session continuity with automated token refresh and change detection
- Normalizes responses across shipments, customs declarations, invoices, and warehouse orders so you integrate once and rely on consistent objects
- Aligns with tenant-specific branch structures, registries, and entitlements to ensure compliant access
Use CargoWise with AI agents: CargoWise MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, branch structure, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready CargoWise adapter tailored to your tenant configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as CargoWise evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a CargoWise tenant using OAuth 2.0 client credentials or username/password and obtain a session token for downstream calls.
Shipments
/shipmentsList shipments and consignments across air, ocean, road, and rail with filters for status, mode, branch, and date range.
Shipments
/create_bookingCreate a new forwarding booking or consignment against the carrier and routing configured for your tenant.
Customs
/customs_declarationsRetrieve customs declarations and border filings with status, country, and acknowledgement filters.
Customs
/submit_declarationSubmit a customs declaration with commodity, valuation, and party details to the relevant government gateway.
Tracking
/trackingPull tracking events, milestones, and container or vessel status for shipments and consignments.
Use Cases
Sync shipment and tracking data into your stack
- Pull active shipments, consignments, and bookings from Forwarding into a single warehouse - Stream tracking events and milestones to downstream visibility and customer-portal tools - Reconcile carrier, vessel, and container status across modes for unified shipment 360
Automate customs declaration workflows
- Push customs declarations and border filings into CargoWise and pull acknowledgements back - Attach commodity, valuation, and party data to declarations without portal clicks - Route holds, queries, and releases from government gateways to operations teams
Reconcile invoicing and accruals
- Sync invoices, accruals, and disbursements from CargoWise Accounting into general ledger and AR systems - Match shipment costs and revenue against jobs for margin reporting - Surface unbilled and disputed charges to finance retention workflows
Keep warehouse and order data in sync
- Pull warehouse orders, inventory, and inbound/outbound movements into WMS and ERP systems - Trigger transport and final-mile bookings when warehouse orders are released - Sync eDocs and proof-of-delivery back to customers and partners
Technical Specifications
Authentication
OAuth 2.0 client credentials, username/password, and MFA handled in a managed session
Connectivity
Authenticated browser flows plus CargoWise REST API and eAdapter XML messaging where exposed by the tenant
Response format
Normalized JSON across Shipment, Customs, Invoice, Warehouse, and Tracking objects
Rate limits
Adaptive throttling tuned to your tenant to avoid CargoWise-side limits
Session management
Automatic token refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for shipments, customs, and tracking with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for booking creation, customs status, milestone, and invoice changes
Latency
Sub-second reads on cached entities; multi-second writes when posting through customs and booking workflows
Throughput
Horizontally scaled workers sized to multi-module volume across Forwarding, Customs, Warehouse, and Transport
Reliability
Retry, backoff, and idempotency keys for bookings, declarations, and invoice transactions
Adaptation
Continuous monitoring of CargoWise releases, eAdapter schema changes, and tenant-specific configuration drift
Frequently asked questions
Yes. Supergood normalizes data across Forwarding, Customs & Compliance, Warehouse Management, and Transport, so you can integrate shipment, declaration, invoice, and warehouse entities once across modules.
Both, as available on your tenant. Supergood works against the CargoWise REST API and eAdapter XML messaging layer, plus authenticated browser flows where an endpoint isn't exposed, and normalizes them into a single consistent surface.
Supergood handles OAuth 2.0 app registration and token lifecycles for you. We work with your existing CargoWise entitlements and authenticated sessions rather than requiring you to manage client credentials manually.
Each tenant is profiled against its configured branches, registries, workflows, and document templates. Supergood preserves tenant-specific fields, lifecycle states, and entitlements rather than forcing a generic schema.
Yes. Customs declarations, border filings, and their acknowledgements are exposed through the same normalized API surface, so you can submit and track government filings alongside shipment and invoice data.