API reference

History

Last updated:

What happened to a unit, one kind of event per route, every item with its source

GET/v2/vin/{vin}/operatorssince 2026-10-27

Every carrier this unit was observed running under

One item per day a federal roadside inspection or crash report put a motor carrier on this unit, most recent first, each naming the carrier by US DOT number and linking to it. An observed association on a dated record, not ownership: a leased unit is operated by a carrier that does not own it. `expand=detail` adds the record it was read from and the carrier as it stands on the register. Costs 3 credits when there is at least one item, 0 when there is none.

Path parameters

vinstringrequired

17-character VIN

Query parameters

expandstringoptional

Comma-separated: detail, evidence

limitintegeroptional

Page size

cursorstringoptional

page.nextCursor from the previous page

curl "https://api.cardog.app/v2/vin/2T3R1RFV7MW180266/operators?expand=detail" \
  -H "x-api-key: $CARDOG_API_KEY" \
  -H "Cardog-Version: 2026-10-26"

Response

200VinOperators
vinstring
itemsobject[]

Most recent first

idstring

The fact's content-derived id; stable across reads

observedAtstring

When it was true in the world, YYYY-MM-DD

sourcestring

Who asserted it, as a source ref: "gov:fmcsa"

valueobject
dotNumberinteger

US DOT number of the motor carrier operating the unit that day

refstring

"org:usdot/{dotNumber}"

detailobject | nulloptional

Present with expand=detail; null when the row the fact was read from is no longer served

type"fmcsa.inspection" | "fmcsa.crash"

The federal record that put the carrier on the unit: a roadside inspection or a crash report

documentstring | null

That record, as a document ref: "document:inspection/…" or "document:crash/…"

carrierobject | null

The carrier on the register; null when the DOT number is not on it

dotNumberinteger
refstring

"org:usdot/{dotNumber}"

legalNamestring | null
dbaNamestring | null

Trade name, when the carrier filed one

domicileobject
operation"interstate" | "intrastate-hazmat" | "intrastate" | "unknown"

The carrier's operating classification on its filing: "interstate" (A), "intrastate-hazmat" (B), "intrastate" (C), or "unknown".

powerUnitsinteger | null

Declared power units on the latest filing

linksobject

carrier: the full read. vehicles: the fleet walk.

pageobject
limitinteger
nextCursorstring | null

Pass as cursor for the next page; null on the last page

linksobjectoptional

Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

Example response

4 keys
"response": {
"vin": "3HSDZAPR3KN125464",
"items": [
0: {5 items},
1: {5 items},
2: {5 items},
3: {5 items},
4: {5 items},
5: {5 items},
6: {5 items},
7: {5 items},
8: {5 items},
9: {5 items},
10: {5 items}
],
"page": {
"limit": 100,
"nextCursor": null
},
"links": {
"carriers": "/v2/carriers?q=3HSDZAPR3KN125464"
}
}

Errors400401402429500every non-2xx body is the error envelope

Generated from the contract. Machine-readable spec: GET https://api.cardog.app/v2/openapi.json · markdown twin: /docs/reference/history.md