Introduction

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

Requirements

npm install @terminal49/sdk

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!,
});

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.