`report_transit_time_analysis`

Updated May 19, 20261 min read

Transit-time buckets for delivered shipments over a date range, grouped by an operational dimension.

The right tool to compare how long different carriers / lanes / service levels actually take to deliver — and to detect drift.

Parameters

Name	Type	Required	Description
`tenantId`	string	Yes	The tenant to report on.
`from`	string	Yes	Range start.
`to`	string	Yes	Range end.
`group_by`	string	Yes	Dimension to group transit buckets by — e.g. `carrier`, `merchant`, `delivery_type`, `shipping_route`.
`shipment_type`	string	No	`forward` or `reverse`.
`select`	string	No	json-mask syntax.
`merchant` / `location_access` / `country_access`	string \| string[]	No	Standard scope filters.
`tzoffset`	string	No	Timezone offset.

For each value of group_by, the transit-time distribution — counts in each duration bucket plus typically a mean / median.

"How does transit time compare across carriers for shipments delivered last month?"

report_transit_time_analysis(
  tenantId="…",
  from="2026-04-01",
  to="2026-04-30",
  group_by="carrier"
)

"Transit time by lane for cross-border shipments this quarter."

report_transit_time_analysis(
  tenantId="…",
  from="2026-04-01",
  to="2026-06-30",
  group_by="shipping_route"
)

report_carrier_performance — broader carrier KPIs of which transit time is one.
report_sla_compliance — same data viewed through the SLA lens.
report_shipment_volume_trend — pair when the user wants both how many and how long.

Reports → Transit Time.