Public API · v1 · FMCSA + NHTSA

Carrier Intelligence API

Every insight on a Vektor carrier profile — load verdict, safety, authority, insurance continuity, equipment, operating footprint, fraud-network signals, and decoded VIN history — in one authenticated JSON call over the live federal record.

Authentication

Every request needs an API key

Send your key as a bearer token or an X-API-Key header. Keys are issued per owner with a request-rate tier. Keys are currently issued by our team — contact us and we'll set you up.

curl -s "https://vektortms.com/api/v1/carriers/2295799" \
  -H "Authorization: Bearer $VEKTOR_API_KEY"

Endpoints

Interactive reference › · base https://vektortms.com · discovery at /api/v1 · OpenAPI

Method	Path	Description
GET	/api/v1/carriers	Look up by name or USDOT (q) + facets. Each row returns the verdict tier, score, and headline so you can pick a carrier, then fetch /{dot} for the full evaluation.
GET	/api/v1/carriers/{dot}	Full carrier evaluation by USDOT — a flat `summary` (name, units, full address, phone, email, website, icon, status, authority age, OOS rate vs national, and the Vektor score with plain-English reasons) plus the complete nested bundle.
GET	/api/v1/units/{vin}	Decoded VIN identity + cross-carrier inspection & plate history.
GET	/api/v1/insurers/{slug}	Insurer book — coverage mix, typical insured-carrier size, sample carriers.

Response envelope

Success returns { data, meta }; errors return { error: { code, message } }.

{
  "data": { /* the resource */ },
  "meta": { "source": "FMCSA (MCMIS / L&I) + NHTSA vPIC …", "as_of": "2026-06-23" }
}

Access & caching

Each key enforces a per-second rate limit and a monthly request quota — both set when your key is issued.
Responses cache per-client for up to an hour (Cache-Control: private, max-age=3600) — no shared/CDN caching, so quota is always metered.
Data is the live FMCSA/NHTSA record, refreshed daily. meta.as_of dates each payload.

Decision support — not an FMCSA safety rating. Sources: FMCSA SAFER · L&I · NHTSA vPIC.