TrackJet

Detect tracking number format

Given a raw tracking number, identify the shipment format (IATA MAWB, ISO 6346 ocean container, UPU S10 postal, UPS 1Z parcel, FedEx, DHL, etc.) and the public TrackJet vertical that owns the lookup. Returns the normalized number, the primary detection match with its confidence flag, all candidate matches sorted by priority, and any catalog-curated carrier match (Cainiao LP, Evri GB10, J&T Express JT12, etc.). Use BEFORE asking the user to clarify — most numbers resolve unambiguously. The respon

Get carrier metadata by slug

Look up a carrier in TrackJet's catalog by its URL-safe slug (e.g. "cainiao", "evri", "maersk-bol", "royal-mail"). Returns canonical name, category (parcel / post_ems / air_cargo / ocean / freight), country of registration when known, official tracking URL with link type (deep_link / search_page / b2b_only / unknown), and any number-format regex used for auto-detection. Production-table rows take precedence over catalog rows when both exist. Use this when you already know which carrier the user

Get the tracking URL for a number

Given a raw tracking number, return the single best URL to send the user to for live tracking. The URL is one of: (a) the carrier's official tracking page directly (deep link or search page) when TrackJet has a curated mapping for that carrier, or (b) a TrackJet vertical route that resolves the carrier on landing (e.g. /post/RR008310255CN routes through TrackJet which then forwards to the postal operator). Always returns at least the /track universal landing as a safe fallback. The response incl

List supported carriers by category

Enumerate the carriers TrackJet knows about. Filter by `category` (parcel, post_ems, air_cargo, ocean, freight) to scope the list, or omit it to get the production directory across all categories. Each entry includes slug, display name, category, country (when known), and whether a curated tracking URL is available. Combine with `get_carrier_info` to fetch full metadata for a specific carrier. The catalog includes 1,669 carriers; default `limit` is 50 — use pagination via `offset` to walk the lo

Get live shipment events (DHL Group)

Fetch live tracking events for a DHL Group shipment number (DHL Express, DHL Paket, DHL eCommerce, DHL Freight, DHL Global Forwarding) via the official DHL Unified Tracking API. Returns timestamped events with status, status code, and location when DHL provides them. Each response carries the canonical attribution "Tracking data provided by Deutsche Post DHL Group" and a resale_allowed=false flag — display these to your end user; do not store, resell, or redistribute the events. For non-DHL carr

Get TrackJet capabilities snapshot

Returns a live snapshot of what TrackJet can do RIGHT NOW. Includes the number of carriers in the production catalog vs. the catalog overlay, the list of tracking-number formats the detector recognises, the set of carriers for which TrackJet pulls real events from a licensed API (today: DHL UTAPI), the available MCP tools, and the current production data volume (shipments tracked, delivery observations recorded, routes with a mature ETA model). Includes an explicit list of things TrackJet does N

Estimate shipment CO2e (GLEC / ISO 14083)

Estimate the carbon footprint (kg CO2e) of a shipment from its transport mode, weight and distance, using GLEC Framework / ISO 14083 default modal intensity factors — the same factors trackjet.world's on-page calculator and REST API use. This is an ESTIMATE based on modal defaults (the response carries is_estimate=true and the methodology string); actual emissions depend on vehicle, load factor, fuel and routing. Valid modes: air, ocean, road, rail. Typical mapping from TrackJet verticals: air_c

Verify a shipment timeline (tamper-evidence)

Check whether a tracked shipment's event history is intact. TrackJet seals every recorded event into a SHA-256 hash-chain at ingest time (spec tjvt2, see trackjet.world/standards/verifiable-timeline); this tool re-verifies the chain and reports the chain digest plus one of: valid, event_mismatch (the stored events differ from what was sealed — actual tampering), events_unavailable (the seal chain is intact but the events it covers were deleted by data retention, so it cannot be re-derived — NOT

Great-circle distance between two locations

Resolve two location identifiers (IATA code, UN/LOCODE, ICAO code, or an unambiguous "City, CC") against TrackJet's locally imported UN/LOCODE 2025-1 + OurAirports data and return the great-circle (haversine) distance in km. IMPORTANT: this is the shortest path on the sphere — NOT the sailed ocean route, flown airway or driven road (e.g. Rotterdam–Singapore is ~10,500 km great-circle but ~15,000 km sailed via Suez); every response carries is_great_circle=true. Ambiguous names refuse to resolve r

Typical route transit time (TrackJet own data)

p50/p90 transit duration for a (vertical, origin country, destination country[, carrier]) route, computed exclusively from TrackJet's own anonymous observations of completed tracked shipments. A route answers ONLY when mature (>=10 real observations) — otherwise matured=false with no numbers: do not invent transit times from an immature answer. Verticals: parcel, post_ems, air_cargo, container, bol. Countries are ISO 3166-1 alpha-2.

Shipment time-truth assessment (TrackJet own data)

Assess the time-consistency of a shipment's carrier history that TrackJet has already observed. Returns truth_score (0..1), consistent (bool), observation_latency_hours (how late we recorded it vs the carrier's latest event), freshness_hours, and counts of chronology_out_of_order / future_dated_events / status_regressions, plus human-readable flags. This is a factual per-shipment check, NOT a statistic and NOT a delivery prediction. Returns found=false when TrackJet has no stored events for the

Delivery probability forecast (TrackJet own data)

Probability that a shipment is delivered within 1/2/3/5/7/10/14 days, plus remaining-time p50/p90, from a Monte-Carlo + Markov model over TrackJet's own observed transit times for the (vertical, origin country, destination country[, carrier]) route, conditioned on current_status and elapsed_hours. Answers ONLY for mature routes (>= 8 real observations) — otherwise matured=false with no numbers: do not fabricate a probability. This is probabilistic, NOT a delivery guarantee. Verticals: parcel, po