## Reference: History

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

**Availability: live** on `https://api.cardog.app`.

### GET /v2/vin/{vin}/operators

Every carrier this unit was observed running under *Since 2026-10-27.*

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**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `vin` | string | yes | 17-character VIN |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `expand` | string | no | Comma-separated: `detail`, `evidence` |
| `limit` | integer | no | Page size |
| `cursor` | string | no | `page.nextCursor` from the previous page |

**Response 200** `VinOperators`: Observations, most recent first

- `vin` (string)
- `items` (object[]): Most recent first
  - `items[].id` (string): The fact's content-derived id; stable across reads
  - `items[].observedAt` (string): When it was true in the world, YYYY-MM-DD
  - `items[].source` (string): Who asserted it, as a source ref: "gov:fmcsa"
  - `items[].value` (object)
    - `items[].value.dotNumber` (integer): US DOT number of the motor carrier operating the unit that day
    - `items[].value.ref` (string): "org:usdot/{dotNumber}"
  - `items[].detail`? (object | null): Present with `expand=detail`; null when the row the fact was read from is no longer served
    - `items[].detail.type` ("fmcsa.inspection" | "fmcsa.crash"): The federal record that put the carrier on the unit: a roadside inspection or a crash report
    - `items[].detail.document` (string | null): That record, as a document ref: "document:inspection/…" or "document:crash/…"
    - `items[].detail.carrier` (object | null): The carrier on the register; null when the DOT number is not on it
      - `items[].detail.carrier.dotNumber` (integer)
      - `items[].detail.carrier.ref` (string): "org:usdot/{dotNumber}"
      - `items[].detail.carrier.legalName` (string | null)
      - `items[].detail.carrier.dbaName` (string | null): Trade name, when the carrier filed one
      - `items[].detail.carrier.domicile` (object)
      - `items[].detail.carrier.operation` ("interstate" | "intrastate-hazmat" | "intrastate" | "unknown"): The carrier's operating classification on its filing: "interstate" (A), "intrastate-hazmat" (B), "intrastate" (C), or "unknown".
      - `items[].detail.carrier.powerUnits` (integer | null): Declared power units on the latest filing
      - `items[].detail.carrier.links` (object): `carrier`: the full read. `vehicles`: the fleet walk.
- `page` (object)
  - `page.limit` (integer)
  - `page.nextCursor` (string | null): Pass as `cursor` for the next page; null on the last page
- `links`? (object): Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

**Errors** (all use the ErrorEnvelope): 400, 401, 402, 429, 500

**Example: cURL**

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

**Example: TypeScript** (`npm install @cardog/api`)

```typescript
import { CardogClient } from "@cardog/api";

const client = new CardogClient({ apiKey: process.env.CARDOG_API_KEY });

const vinOperators = await client.v2.vin.operators("2T3R1RFV7MW180266", { expand: "detail" });
console.log(vinOperators.vin);
```

**Example: Python** (`pip install cardog`)

```python
import os

from cardog import Cardog

client = Cardog(api_key=os.environ["CARDOG_API_KEY"])

vin_operators = client.v2.vin.operators("2T3R1RFV7MW180266", expand="detail")
print(vin_operators.vin)
```

---

Previous: [Parts](https://cardog.app/docs/reference/parts.md) (API reference)
Next: [Carriers](https://cardog.app/docs/reference/carriers.md) (API reference)