v1

latestOpenAPI 3.0.32026-07-23273969.2 KB
Compliance Rules

Get carrier compliance rules by USDOT (single or batch)

Returns carrier compliance rules for one or more USDOT numbers.

  • Single mode: provide usdot_number. The response shape is a single object with rules and rule_status and is fully backward compatible with the existing API.
  • Batch mode: provide usdot_numbers as a comma-separated list. The response shape is an object with a results array where each item represents one USDOT and includes a found flag.

When both usdot_number and usdot_numbers are provided, usdot_numbers takes precedence and usdot_number is ignored. The maximum number of USDOT values allowed in usdot_numbers is limited to 50. Requests that exceed this limit return HTTP 400. Each batch result item uses found=false when no vetting data exists for that USDOT. In that case the item only contains usdot_number and found. When found=true, rules and rule_status are populated with the same structure as the single-USDOT response. Examples:

  • Single: /compliance-rules?usdot_number=1234567
  • Batch: /compliance-rules?usdot_numbers=1234567,7654321
get/compliance-rules

Query parameters

usdot_numberstring

Single USDOT number to evaluate. Ignored when usdot_numbers is also provided.

usdot_numbersstring

Comma-separated list of USDOT numbers for batch evaluation. When provided, this parameter takes precedence over usdot_number.

Response

Compliance rules retrieved successfully (single or batch).

  • Single: single carrier response (rules + rule_status). - Batch: list of per-carrier results with found flags.
OR