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

npm install @terminal49/sdk
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:
export T49_API_TOKEN=your_api_key
Then initialize the client:
import { Terminal49Client } from '@terminal49/sdk';

const client = new Terminal49Client({
  apiToken: process.env.T49_API_TOKEN!,
});

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