Terminal49 API and DataSync Updates

​

Pickup & Delivery Dashboard

​

Bulk party (role) assignment

​

Event-driven calculated demurrage LFD

​

Refreshed ONE, CMA CGM, and Evergreen tariffs

​

Updates

• t49_calculation source on the shipment timeline — events created by the Smart LFD calculation engine now surface a t49_calculation source tag in the dashboard event timeline, so you can tell at a glance which LFD updates came from a tariff calculation
• Manual milestone edits flow through the event pipeline — user-submitted empty-in, full-out, and delivery-appointment events are now created as proper transport events. They update container attributes, fire container.transport_event webhooks, and appear consistently in the timeline like carrier-sourced events
• Updated Wayfair arrival notice extraction — published a new versioned extraction schema for Wayfair arrival notices with refreshed gold datasets and classifier prompts, improving field-level accuracy on Wayfair documents
• Sort container dashboard by shipment number — added Shipment Number as a sortable column on the container dashboard
• Sort container dashboard by delivery appointment — added delivery appointment as a sortable field on the containers API and dashboard
• PAYG billing clarification — the billing settings page now clearly explains how active free containers are counted on Pay-As-You-Go plans
• Bookings removed from the left nav — the Bookings preview entry has been removed from the dashboard navigation while the workspace continues to evolve

​

Bug fixes

• Tracking slot limit no longer blocks paying customers — Fixed an issue where the active tracking slot limit could incorrectly block paying accounts from creating additional tracking requests. The limit and its warning now apply only to free plans
• CMDU ambiguous port events — Rejected ambiguous CMDU port events that could otherwise be attributed to the wrong leg, and excluded pre-POD events from the destination-port heuristic so inland destinations are inferred more accurately
• YMLU POD selection — Fixed port-of-discharge selection for YMLU shipments where only container-level data was available, so the correct POD is chosen
• NSRR top-level ETA — Fixed parsing of Norfolk Southern’s top-level ETA so rail ETAs populate when the carrier returns them at the response root
• WMC unavailable terminal status — Where’s My Container responses that report a container as unavailable are now handled cleanly instead of failing the terminal scrape
• Removed sort custom field columns are forgotten — Deleting a custom field used as the active sort no longer leaves the dashboard stuck on an unknown sort column
• Map route Pylon widget — Fixed the Pylon help bubble showing on the global vessel map; it now hides and re-shows correctly when navigating in and out of the map

​

Global vessel map is now generally available

​

Wayfair document extraction improvements

• Arrival notice now captures place of delivery (name, address, phone, available date, last free day, FIRMS code, and sublocation)
• FIRMS code routing distinguishes rail-ramp destinations from the port of discharge, with both fields populated when both codes appear
• Hapag-Lloyd Canada “Advice Note / Avis d’Expédition” documents are now correctly classified as arrival notices (previously misclassified as sea waybills)
• Tighter I vs 1 disambiguation across carriers

​

BL submissions without containers

​

New contract products

• Lite — a lower-tier subscription for smaller-volume customers
• Integration service fee — a separate line item for one-time integration work

​

Updates

• Pending tracking requests count as one slot — Pending tracking requests are now counted against a single tracking slot rather than per-container, giving free and metered plans more headroom while requests are awaiting manifest
• HDMU mobile LFD locations — Last Free Day events from the HDMU mobile tracker now infer the correct terminal location, fixing missing per-terminal LFD displays for Hyundai (HDMU) containers
• SSL overview no longer overwrites terminal data — Shipping line overview responses no longer overwrite terminal-sourced fields on containers, so terminal availability, holds, and fees stay authoritative when both sources are present
• Empty-In can override terminal status — A reported empty-in event now correctly overrides a stale terminal status, so containers returned empty are reflected promptly in the dashboard and API
• Transport event location fallbacks removed — Removed legacy fallbacks that could fill in incorrect locations on transport events. Event locations now reflect the source data directly, with no implicit substitutions

​

Bug fixes

• ZIM destination ETA no longer auto-promotes to ATA — Fixed an issue where ZIM destination ETAs could be promoted to an actual arrival time prematurely, causing inland arrival dates to flip without a real event
• Document linking via bridge shipments — Documents no longer create an intermediate link when more than one shipment is involved in a reference bridge, reducing incorrect cross-shipment links
• Dashboard custom field date filters — Fixed an error where the not present operator failed on date and datetime custom field filters, and resolved a related stale sort issue
• Harbor filter search — Restored search inside the dashboard’s chip-style filter dropdowns after the underlying picker upgrade
• Trawler no_event_history with containers — Allowed the no_event_history tracker state to coexist with container records, preventing dropped updates for shipments whose carriers temporarily return no event history

​

Tracking request custom fields API

​

KMTC steamship tracker

​

New terminal integrations

• Termont (Montreal) — added a WordPress-based scraper for Termont container availability, status, and rail-state data
• APM Terminals — alternative scrapers — two new APM scraper integrations (apmweb_cffi and apmweb_firecrawl) are available alongside the existing APM source, so terminals can be served by whichever endpoint performs best per site

​

Container status in CSV export

​

Report Issue from the container side panel

​

Multi-period tariff history for Smart LFD

​

Updates

• Document linking by custom fields — documents can now be linked to shipments and containers using custom field values, in addition to PO numbers, BOLs, and container numbers
• PO number matching is more forgiving — additional common typo patterns are now matched when linking documents via PO number
• Free plan tracking slot limits — Free accounts now meter against active tracking slots with clearer in-app usage copy, and unknown-container slot handling has been tightened
• Inline custom field option creation — single- and multi-select custom fields now let you create new options inline from the value picker, with several follow-up polish improvements
• Custom field filter-out option — container filters now support filtering for records where a custom field is not set
• Quick link to shipment/container — added a button to copy a direct link to a shipment or container from the dashboard
• EGLV Last Free Day events now include location — EGLV LFD events now carry the inland destination location so per-terminal LFD displays correctly
• Arrival notice classification — fixed an issue where some arrival notices were misclassified as sea waybills during document processing
• Hapag-Lloyd FIRMS code routing — clarified FIRMS code handling on arrival notice extraction so terminal routing is more reliable

​

Bug fixes

• TRKU future events — TRKU events dated in the future are now classified correctly so container timelines no longer skip past upcoming events
• HMM mobile error pages — HMM (HDMU) mobile responses that return an HTML error page are now handled cleanly instead of failing the tracker run
• MAEU tracking — Migrated remaining MAEU traffic off the legacy tracker to MaeusynergyTracker for more reliable Maersk container data
• Document linking edge cases — documents with both an explicit and implicit link no longer fail to link, child packets now inherit only direct links from their parent, and legacy .xls files using the roo-xls path are processed correctly again
• Container state filters — removed the unused “loaded” and “dropped” values from the current-status filter so the dropdown only shows real states
• Dashboard search focus — fixed an issue where selecting a recent search left the input out of focus, and tightened the global click listener that drives dropdowns
• Disabled integrations — disabled integrations no longer appear in the credentials list
• Unknown account handling — webhook and ingestion paths no longer raise when an unknown account is referenced
• Sentry instrumentation — fixed a missing region on the Sentry cassette job and removed a path that could cause Sentry error reporting itself to loop
• Knock in-app guides — improved rendering of the Knock guide banner and moved free-plan Knock syncing to commit-time so guides display reliably

​

link.created webhook

​

Bookings (preview)

​

New terminal integrations

• Port Houston (Barbours Cut, S787) — added a direct API integration for container status, holds, fees, and last free day at Port Houston
• Port of Wilmington (L194) — added a Voyager-based scraper for Port of Wilmington container data

​

Per-account terminal scraper selection

​

value_timestamp on shipping line LFD transport events

​

Draft demurrage tariff rules for ONE, Evergreen, and CMA CGM

​

Expanded CSV bulk update

• Shipment tags and reference numbers can be updated in the same CSV alongside container fields
• Tracking request custom fields can be created and updated in bulk for tracking requests that are still pending or awaiting manifest

​

Manual refresh feedback

​

Custom fields moved to Data Management

​

Daily email digest pacing

​

Bug fixes

• Rail LFD on container pickup — Rail Last Free Day no longer fails to update once a container has been picked up
• APM containers on rail — Fixed an error that could occur for APM containers on rail with no equipment moves, allowing container data to load
• HDMU LFD events — HDMU Last Free Day events now include the correct location for accurate per-terminal LFD display
• Swire ETA fallback — Swire shipments now fall back to the tracking sheet for ETA when the primary source is missing, and route locations are extracted more reliably
• SMLU schedule port calls — Fixed a NoMethodError affecting SMLU schedule lookups so shipments load consistently
• POL/POD location extraction — Improved extraction of port-of-loading and port-of-discharge locations for SSPH, ZIM (ZIMU), TJFH, TXZJ/TXSJ, and YMLU shipments, reducing missing or incorrect route locations
• Terminal scrape error handling — Failures during terminal scrape context resolution are now handled cleanly so they no longer pollute terminal-health metrics
• Steamship tracker rate limits — Expected rate-limit errors from upstream carriers are now silenced and vessel-event extraction is instrumented for better visibility into ingestion health

​

Global vessel map

​

Search by custom field values

​

Sensitive custom fields

​

Configurable duplicate document handling

​

xlsm spreadsheet support

​

Destination ETA for non-US/CA containers without rail data

​

New terminal scrapers

• Felixstowe — added a mobile-site-based scraper as an alternative data source, improving reliability for containers moving through Felixstowe
• DP World Vancouver (3380) — added a public-API scraper for terminal data at DP World Vancouver

​

Promo codes and coupon links for Pay-As-You-Go checkout

​

Bug fixes

• YMLU transshipment events — Fixed spurious full-out events generated at transshipment ports and corrected port-of-discharge mismatches for YMLU shipments
• MSC inland voyage numbers — Stabilized voyage number assignment for MSC inland feeder and barge legs so the same leg no longer appears under different voyage numbers across updates
• ONE event timestamps — Rail unloaded and other ONE events now use port-local time consistently, fixing display and ordering issues for ONE-tracked containers
• Bulk email CSV uploads — Fixed an issue where rows using alternative SCACs were silently dropped from CSVs submitted by email
• Rail carrier lookup — Rail carrier resolution now considers neighboring ports, improving carrier assignment for containers transferring between adjacent rail-served facilities
• Tideworks terminal sessions — A 403 on the CSV endpoint now clears the cached session immediately, preventing a cascade of failed terminal lookups across containers
• Steamship tracker reliability — Proxy and firewall blocks at carrier websites are now classified as TrackerBlocked errors, surfacing a clearer failure reason and enabling targeted retries
• POMTOC (L239) — Routed POMTOC Tideworks requests through a residential proxy and added required Referer/Origin headers to restore data collection
• Free plan container limits — Free plan accounts now meter against active container concurrency rather than monthly cumulative counts, so picked-up and delivered containers no longer count toward the limit
• Duplicate tags — Eliminated a race condition that could cause duplicate tag creation to fail with a unique constraint error
• Postmark email intake — Recipient email lookups are now case-insensitive, fixing missed matches on inbound document emails
• Pay-As-You-Go cancellation — Fixed handling of Stripe subscription period dates so the cancel response returns accurate end-of-period timing for newer subscription structures
• Daily digest jobs — Database errors during daily digest delivery now release the cache lock cleanly so the next run can proceed

​

Booking number support in Infer Tracking Number

​

Delivered date filter and column on the container dashboard

​

Fuzzy search for documents

​

Hold descriptions on container holds

​

Reference number flag on custom field definitions

​

PO number normalization for document linking

​

Bug fixes

• Containers requiring attention — Picked-up, on-rail, empty-returned, and delivered containers no longer appear under the “needs attention” LFD view. Only containers still active at a terminal show up
• Tideworks fees — Containers reported as on a vessel or on rail no longer return stale terminal fees from a previous move
• MSC Port of Discharge events — Improved criteria for selecting the correct POD arrival event on MSC shipments
• LBCT inland transfers — Fixed handling of on-dock-to-inland transfer events at LBCT, so rail moves out of the terminal are tracked correctly
• COSCO vessel departure — Improved logic for determining when a COSCO vessel has departed the port of loading
• Vessel event deduplication — Fixed duplicate vessel events on the shipment timeline coming from carriers and from the CSE invalidation pipeline
• Document linking race condition — Eliminated a race condition that could leave a document briefly unlinked when references arrived from multiple sources at once
• Webhook notifications page — Fixed an exception that could occur when listing webhook notifications containing document processing events
• Carrier integrations — Fixes to MAEU auth handling (now treats 403 correctly), APM Empty In OAuth requests, BNSF rail scraping, NSRR equipment requests, Hapag-Lloyd booking sweeps for shipments with no containers, and Voyager terminal request headers
• Terminal data — Updated headers for SSAMX and Holt agent terminals, and added external location mapping for PCIU
• Document email intake — Tightened sender-email rules so unrelated inbox messages are filtered out, and fixed an edge case where a single email recipient was not handled as an array

​

Smarter document-to-shipment linking

​

Improved document extraction accuracy

​

Bug fixes

• Mark as delivered — Fixed an issue where marking a container as delivered from the dashboard event viewer could fail. User-submitted delivery events are now accepted correctly
• Stale terminal LFD dates — Fixed a bug where outdated Last Free Day dates from a previous cycle could appear on containers still in transit. Terminal LFD events are now rejected until the container arrives at the port
• MSC departure events — Corrected incorrect departure-from-POD events being reported for certain MSC containers
• Hapag-Lloyd tracking — Fixed an error that could occur when Hapag-Lloyd returns an empty shipment overview, preventing container data from loading
• Norfolk Southern rail LFD timezone — Fixed incorrect timezone parsing for Norfolk Southern rail Last Free Day dates, which could shift the date by a day
• Dashboard event viewer — Fixed display issues in the unified event viewer for user-submitted events
• Terminal data collection — Resolved connectivity and data retrieval issues at Goport, Maher, and Packer Avenue terminals, restoring terminal-sourced hold, fee, and availability data for containers at those facilities

​

Dashboard deep linking

https://app.terminal49.com/shipments/find?q={identifier}

​

Calculated Last Free Day

​

Smart LFD dashboard columns

• Calc. Line LFD — the calculated Last Free Day derived from carrier tariff rules
• Smart LFD — the best available LFD with its source displayed, so you can see at a glance whether the date comes from the shipping line, terminal, or a tariff calculation

​

Bug fixes

• Hapag-Lloyd booking tracking — Fixed an issue where certain Hapag-Lloyd bookings could return an invalid number error, preventing container data from loading

​

Smart Last Free Day

• Original — the first LFD reported
• Current — the latest LFD reported
• Calculated — a derived value when the raw date needs adjustment

​

Inland destination ETA source transparency

• Shipping line — ETA provided by the carrier
• Rail — ETA from the rail carrier
• T49 operations team — manually verified ETA
• T49 prediction engine — machine-learning-based estimate

​

Expanded shipping line LFD coverage

​

Bug fixes

• Hapag-Lloyd booking tracking — Fixed an error that could prevent booking equipment data from being returned for Hapag-Lloyd shipments
• Dashboard copy/paste — Copy and paste keyboard shortcuts in the container dashboard no longer interfere with text input fields
• Webhook notification links — The dashboard webhook notifications page now correctly displays reference links for events with multiple related resources

​

TypeScript SDK

• Track containers, retrieve shipments, and manage tracking requests with type-safe methods
• Automatic retry with exponential backoff for rate limits and server errors
• Flexible response formats: raw JSON:API, mapped objects, or both

npm install @terminal49/sdk

​

MCP server

• 10 tools — search, track, get container details, shipment routing, transport events, and more
• 3 prompts — pre-built workflows for tracking, demurrage analysis, and delay root cause analysis
• Connect with a single config block — no custom code required

​

Custom Fields API

• Custom Field Definitions — create, update, list, and delete field schemas scoped to shipments or containers
• Custom Field Options — manage allowed values for select-type fields
• Custom Fields — assign values to specific shipments or containers

​

Webhook trigger endpoint

​

DataSync improvements

• Shipping line Last Free Day — new ssl_last_free_day_on and ssl_last_free_day_on_local columns on both the containers and containers_rail tables, so you can distinguish the shipping line’s LFD from the terminal’s LFD
• Pending hold status — individual hold columns (freight_hold, customs_hold, usda_hold, tmf_hold, other_hold) now support a "Pending" value in addition to "Hold" and blank, giving you earlier visibility into holds before they become active

​

Container Holds, Fees, and Release Readiness

• Pickup readiness logic — a decision flowchart and code example showing how to combine available_for_pickup with holds_at_pod_terminal to determine if a container can be picked up
• Hold and fee enum references — quick-reference tables for all hold names and fee types, with expandable details for each value
• Webhook changeset examples — how to subscribe to container.updated and react to hold/fee changes in real time
• Rail and inland destinations — clarification that the same fields apply at inland rail terminals, not just the port of discharge
• FAQ — answers to common integration questions like double-counting fees, sync lag between holds and availability, and case-sensitive hold names

​

Infer Tracking Number (Beta)

• The VOCC SCAC to use for tracking
• The number type (container, bill of lading, booking)
• A confidence-driven decision (auto_select, needs_confirmation, no_prediction)

​

Documentation improvements