Identify a digital freight forwarder (such as Flexport, Freightos, or a similar platform) that exposes a documented REST API; complete the developer onboarding and obtain OAuth credentials or API keys per the platform's authentication documentation.
Create a shipment booking request via the API specifying origin, destination, incoterms, cargo details (weight, dimensions, commodity, HS code), and required service (FCL ocean, LCL, air).
Upload commercial invoice, packing list, and certificate of origin documents to the forwarder's document management API endpoint; confirm the platform acknowledges receipt and assigns each document to the shipment.
Subscribe to shipment milestone webhooks or poll the status endpoint to track events: booking confirmed, cargo pickup, origin port departure, transshipment, destination port arrival, customs clearance, and final delivery.
Retrieve the Master Bill of Lading number and House Bill of Lading number from the API after booking confirmation; use these references to track the shipment on carrier systems and reconcile against customs filings.
Pull freight invoices from the forwarder's invoice API after shipment completion; match invoice line items against the original quote for audit, and flag discrepancies for dispute before payment.
Known gotchas
Digital forwarder APIs are proprietary and vary widely in capability; some offer full booking and document APIs while others provide only status visibility — confirm API scope before committing to a platform.
House bill of lading numbers issued by freight forwarders differ from the master B/L issued by the ocean carrier; both are needed for customs filing and tracking — ensure your data model stores and links both references.
Forwarder-quoted all-in rates often exclude destination charges (THC, customs examination fees, delivery order fees); request a detailed charge breakdown via the API before presenting total cost to stakeholders.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp