ae58c064a7af
Get a carrier’s safety benchmark
A carrier’s safety standing: a FIXED overall score and letter grade (computed once against the canonical peer model — it never changes with the lens) plus a peer comparison re-framed against whichever peer_group you pick. Percentiles are always oriented so 100 is best. Check peer_group.reliable before presenting comparisons; thin buckets (n < 384) are returned flagged, never hidden. Data refreshes weekly (as_of). 404 no_benchmark means the carrier has no inspection history, not an invalid DOT.
Path parameters
The carrier’s USDOT number
Query parameters
Comparison lens — any group_type from GET /v1/peer-groups (33 lenses). Unknown values return 400.
Comma-separated subset of: overall, categories, metrics, violations, flags (default: all five)
Advanced: compare against a specific peer bucket (e.g. "2-5 Trucks | Local") instead of the carrier’s own
Max inline violation rows; page the /violations sub-resource for the full list
Response
Fixed standing plus the requested sections framed by the chosen lens