Team plan

API reference

Read carrier records, manage your watchlist and pull alerts and new registrations from your own systems. JSON over HTTPS.

Authentication

Create a key under Settings in your dashboard (Team plan). Send it as a bearer token:

curl https://carriervitals.com/api/v1/carriers/1234567 \
  -H "Authorization: Bearer cv_live_..."

Limit: 120 requests per minute per key. Errors return {"error": "..."} with a 4xx status.

Endpoints

MethodPathReturns
GET/carriers/{usdot}Carrier record with authority, insurance filings, inspections, risk flags, the pass / review / fail result against your vetting rules (vetting) and trucks seen under other carriers (shared_trucks)
GET/carriers/{usdot}/eventsChange history for one carrier
GET/search?q=Search by name, USDOT or MC number
GET/watchlistYour watched carriers
POST/watchlistAdd carriers: {"usdot": [123, 456]}
DELETE/watchlist/{usdot}Stop watching a carrier
GET/alerts?since=YYYY-MM-DDChanges on your watched carriers
GET/new-carriers?state=TX&since=YYYY-MM-DDNewly registered carriers with contact details

Webhooks

On Pro and Team, set a webhook URL under Settings. After each daily refresh we POST one JSON document per account:

{
  "type": "carrier.changes",
  "date": "2026-11-17",
  "changes": [
    { "usdot": 1234567, "legal_name": "EXAMPLE TRUCKING LLC",
      "change": "Authority revocation pending",
      "detail": "Common carrier (MC123456)",
      "severity": "Critical", "code": "REVOCATION_PENDING",
      "url": "https://carriervitals.com/carrier/1234567-example-trucking-llc" }
  ]
}

Respond with any 2xx status. Delivery is attempted once per refresh; missed changes stay available under /alerts.