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
| Method | Path | Returns |
|---|---|---|
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}/events | Change history for one carrier |
GET | /search?q= | Search by name, USDOT or MC number |
GET | /watchlist | Your watched carriers |
POST | /watchlist | Add carriers: {"usdot": [123, 456]} |
DELETE | /watchlist/{usdot} | Stop watching a carrier |
GET | /alerts?since=YYYY-MM-DD | Changes on your watched carriers |
GET | /new-carriers?state=TX&since=YYYY-MM-DD | Newly 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.