The trip-stats read returns a summary of a load's whole recorded GPS track: distance, duration, average and maximum speed, hard acceleration and braking counts, city/highway split and GPS coverage. It costs $0.02 per request over the Agent API or MCP.
$0.65 per load · $0.02 per position read over the API · live map and tracking link in the cabinet free · no subscription
| Field | Meaning |
|---|---|
dataPoints | GPS positions recorded for the load |
durationSeconds, firstAt, lastAt | Span of the track |
estimatedDistanceMiles | Distance along the full track |
avgSpeedMph, maxSpeedMph | Speeds over the whole span, stops included |
hardAccelCount, hardBrakeCount | Speed changes over 15 mph per minute while moving |
cityMilesPct, highwayMilesPct | Share of miles at 5–45 mph and above 45 mph |
parkedTimePct, nightPct | Share of positions parked, and between 23:00 and 07:00 UTC |
coveragePct | Positions received against one per minute, capped at 100 |
Meant for delivered loads (post-trip review, detention evidence); on a load in progress it returns the trip so far.
GET https://api.suverse.io/v1/agent/loads/{loadNumber}/trip-stats
Authorization: Bearer sup_agent_…
Facts checked 2026-11-05.