Skip to main content
The Terminal49 TypeScript SDK lets you track containers, retrieve shipment data, and receive status updates from your Node.js applications.

Requirements

Install

Package links:

Support policy

  • Node.js is the only supported runtime; browser, Deno, and Bun are not supported.
  • Versioning follows npm package versions. Pin a specific version in production and review the changelog before upgrading.
  • Use of the SDK is governed by Terminal49’s terms of service. The npm package does not declare an open-source license.

Setup

Store your API key as an environment variable:
Then initialize the client:

What you can do

  • Track containers — Create tracking requests by container number, booking number, or bill of lading
  • List shipments and containers — Query with filters by status, port, carrier, or date
  • Get transport events — Pull milestones, timestamps, and location updates
  • Fetch routing details — See the full journey including vessels and ports
For real-time updates, set up webhooks to receive status changes as they happen.

Next steps

Quickstart

Track your first container in 5 minutes

Methods reference

See all available SDK methods

TypeScript API reference

Browse SDK classes, interfaces, and types