report_carrier_performance

Aggregated carrier-level KPIs such as shipment share, success rate, service-level performance, and average transit timings.

The right tool when the question is "which carriers are working, which aren't?" or "how should I rebalance traffic?".

Parameters

Name	Type	Required	Description
tenantId	string	Yes	The tenant to report on.
from	string	Yes	Range start.
to	string	Yes	Range end.
shipment_type	string	No	forward or reverse.
select	string	No	json-mask syntax.
merchant / location_access / country_access	string | string[]	No	Standard scope filters.

Returns

A row per carrier (carrier account, really) with KPIs:

• Shipment share — % of total volume
• Success rate — % delivered without exceptions
• Service-level performance — % within promised windows
• Average transit timings — typically by stage (booked → picked, picked → delivered)

Example agent prompts

"How are my carriers performing this month?"

report_carrier_performance(
  tenantId="…",
  from="2026-04-07",
  to="2026-05-07"
)

"Compare DHL and Aramex performance for KSA shipments last quarter."

report_carrier_performance(
  tenantId="…",
  from="2026-02-01",
  to="2026-04-30",
  country_access="SA"
)

The agent then post-filters or describes the DHL / Aramex rows.

Related tools

• report_sla_compliance — same data through the SLA lens.
• report_transit_time_analysis — same data through the transit-time lens.
• report_failed_delivery_analysis — drill into the failures behind a low success-rate carrier.
• get_carrier_accounts (lookup) — get the list of carrier accounts before reporting on them.

Common chain

Why did SLA slip last week? — report_sla_compliance → report_carrier_performance → report_failed_delivery_analysis.

Equivalent in the dashboard

Reports → Carrier Performance.