1. 4. Shipments & Fleet
DUFREI API
  • Raíz
    • 1. Core & Health
      • Health Check
    • 2. AI Agents & MCP
      • Model Context Protocol (Streamable HTTP)
      • Initialize Legacy SSE Stream
      • Send Legacy MCP JSON-RPC Message
    • 3. Financial Documents
      • List Financial Documents
      • Cash Inflow Forecast & Customer Concentration (HHI)
      • Discounts, Demurrage & Shrinkage Recovery Audit
    • 4. Shipments & Fleet
      • List Shipments (Trips)
        GET
      • Audit Fleet Utilization and Productivity
        GET
      • Audit Dispatch-to-Bill and Invoicing Efficiency
        GET
      • Freight Financial Unit Economics ($/km, $/L)
        GET
    • 3. Financial & Invoices
      • SAT CFDI 4.0 Monthly Fiscal Ledger & Retention Reconciliation
    • 5. Scheduled Alerts
      • Schedule Alert Rules
  • Schemas
    • PaginationMeta
    • FinancialDocsResponse
    • ShipmentsResponse
    • FinancialSummary
    • TripSummary
    • ErrorResponse
    • CanceledRecord
    • PaymentRecord
    • FinancialDocument
    • MexicanAddress
    • ShipmentLeg
    • TripDocument
    • ScheduleAlertsRequest
    • ScheduleAlertsSuccessResponse
    • McpJsonRpcRequest
    • McpJsonRpcResponse
    • RouteCatalogDetails
    • FleetUtilizationResponse
    • DispatchToBillResponse
    • CashInflowForecastResponse
    • DiscountsAndShrinkageResponse
    • FinancialUnitEconomicsResponse
  1. 4. Shipments & Fleet

Audit Fleet Utilization and Productivity

GET
/api/fleet-utilization
Calculates tractor fleet utilization, active vehicles, trips count, volume in liters, freight revenue,
Full double-trailer ratio, and underutilized asset alerts for the authenticated tenant.

Solicitud

Autorización
API Key
Agregar parámetro en header
x-api-key
Ejemplo:
x-api-key: ********************
or
Parámetros de consulta

Respuestas

🟢200
application/json
Successful fleet utilization audit.
Encabezados

Bodyapplication/json

🟠401Unauthorized
🟠429TooManyRequests
🔴500InternalServerError
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.dufrei.com/api/fleet-utilization?limit=&client=&startDate=&endDate=&minTripsActive=' \
--header 'x-api-key: <api-key>'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "meta": {
        "tenant": "XAXX010101000",
        "totalTripsAudited": 416
    },
    "fleetSummary": {
        "totalActiveVehicles": 18,
        "totalFleetTrips": 416,
        "totalFleetShipmentLegs": 620,
        "totalFleetVolumeLiters": 17500000,
        "totalFleetWeightKg": 12500000,
        "totalFleetFreightMxn": 11142857.92,
        "totalFleetFullTrips": 204,
        "totalFleetSencilloTrips": 212,
        "fleetFullRatioPct": 49,
        "avgTripsPerVehicle": 23.1,
        "avgVolumePerVehicle": 972222.22,
        "avgFreightPerVehicleMxn": 619047.66
    },
    "utilizationRanking": [
        {
            "vehicle": "TR-102",
            "tripsCount": 28,
            "shipmentLegs": 56,
            "fullTripsCount": 28,
            "sencilloTripsCount": 0,
            "fullRatioPct": 100,
            "totalVolumeLiters": 1792000,
            "totalWeightKg": 1500000,
            "totalFreightMxn": 750000.16,
            "avgFreightPerTripMxn": 26785.72,
            "avgTurnaroundHours": 41.5,
            "productivityTier": "ALTA_PRODUCTIVIDAD"
        }
    ],
    "underutilizedAlerts": [
        {
            "vehicle": "TR-099",
            "tripsCount": 1,
            "totalFreightMxn": 26785.72,
            "benchmarkFleetAvgTrips": 23.1,
            "alertSeverity": "CRITICA",
            "recommendedAction": "string"
        }
    ]
}
Modificado en 2026-09-20 15:05:35
Anterior
List Shipments (Trips)
Siguiente
Audit Dispatch-to-Bill and Invoicing Efficiency
Built with