Put a broker’s pay grade where the decision gets made.

Authentication

Operator-issued keys. Send your key in the X-Api-Key header. Keys are scoped and rate-limited.

curl https://brokerverify.us/api/v1/brokers/MC-204417 \
  -H "X-Api-Key: bv_live_…"

Scopes (role-based access)

• Grade — letter grade, 0–100 score, provisional flag, formula version, as-of date.
• Metrics — avg days-to-pay, paid-in-full %, deduction / short-pay / accessorial counts, loads on file, evidence-tier mix.
• Reports paid tier — up to 5 anonymized recent figures (month, agreed vs paid, days-to-pay, flags). Never any reporter identity, rate-con number, exact date, or lane.

Endpoints

GET /api/v1/brokers/{docket} — single lookup.
POST /api/v1/brokers/batch — up to 100 caller-supplied dockets per call.

There is no “list all brokers” endpoint. You always supply the MC. Usage is metered per docket resolved.

Example response

{
  "legalName": "Westbound Freight Brokers",
  "docket": "MC-204417",
  "dotNumber": "9880233",
  "grade": { "letter": "A-", "score": 88, "provisional": false, "formulaVersion": "v2.3", "asOf": "2026-03-20T00:00:00Z" },
  "metrics": { "avgDaysToPay": 19, "paidInFullPct": 98, "loadsOnFile": 37, "...": "..." },
  "methodology": "Neutral automated aggregation…",
  "disclaimer": "Grades are informational guidance, not a guarantee…"
}