Terminal49 SDK Quickstart

import { Terminal49Client } from '@terminal49/sdk';

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

async function main() {
  // 1) Track a container (creates a tracking request)
  // Provide a SCAC for faster, more reliable inference when known.
  await client.trackingRequests.createFromInfer('MSCU1234567', {
    scac: 'MSCU',
  });

  // 2) List shipments created since a timestamp (one mapped page)
  const shipments = await client.shipments.list(
    { created_at: '>=2026-10-01T00:00:00Z' },
    { format: 'mapped' },
  );
  console.log(`Fetched ${shipments.items.length} shipments on this page`);

  // 3) Get a specific container with related data (raw JSON:API)
  const containerId = 'your-container-uuid';
  const container = await client.containers.get(containerId, [
    'shipment',
    'pod_terminal',
  ]);
  console.log(container.data?.id);

  // 4) Get transport events (milestones and timeline)
  const events = await client.containers.events(containerId, {
    format: 'mapped',
  });
  console.log(`Container has ${events.length} events`);

  // 5) Get the route: ports in order and the current vessel.
  // Requires the Routing Data feature; otherwise this throws FeatureNotEnabledError.
  const route = await client.containers.route(containerId, {
    format: 'mapped',
  });
  console.log(`Route has ${route.totalPorts} ports`);
}

main();