v1

latestOpenAPI 3.1.02026-07-13255378.3 KB

Get aggregated carrier risk signals

Aggregated carrier risk assessment in a single call. Returns an AI-generated risk score (0-10) and level, plus six signal categories — authority-for-sale listings, equipment-for-sale marketplace matches, financial-distress indicators, fraud/chameleon patterns, historical authority/insurance/change-event patterns, and recent news sentiment. Each category carries a derived level of "high", "medium", "clear", or "unknown". The risk summary is cached; pass force_refresh=true to force regeneration.

get/v1/carriers/{dot_number}/risk-signals

Path parameters

dot_numberstring required

The carrier's USDOT number

Query parameters

force_refreshboolean

Set to true to bypass the cached risk summary and regenerate it from current signals (slower).

include_equipmentboolean

Set to false to skip the equipment-marketplace VIN lookup for a faster response.

Response

Scored risk header plus six derived signal categories

dot_numberstring

carrier_namestring nullable

risk_scorenumber nullable

AI-generated 0–10 risk score

risk_levelstring

CRITICAL, HIGH, MEDIUM, LOW, CLEAR, or UNKNOWN

summarystring nullable

generated_atstring date-time nullable

cachedboolean nullable

summary_availableboolean

False when the upstream summary service was unavailable and a carrier-stored fallback was used.