---
title: "Get carrier change-event and authority timeline"
method: GET
path: "/v1/carriers/{dot_number}/timeline"
---

# Get carrier change-event and authority timeline

`GET /v1/carriers/{dot_number}/timeline`

Merged chronological feed of carrier change events and authority history. Combines field-level changes from monthly FMCSA census diffs (contact, address, fleet, operations, authority, people) with authority history records.

## Path parameters

- `dot_number` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `category` string
- `date_from` string, date
- `date_to` string, date

## Response `200`

Merged timeline of change events and authority actions

- TimelineResponse
  - `dot_number` string
  - `total` integer
  - `category_counts` object
  - `limit` integer
  - `offset` integer
  - `events` TimelineEvent[]
    - `id` union
      - integer
      - string
    - `dot_number` string
    - `detected_at` string, date
    - `category` 'contact' | 'address' | 'fleet' | 'operations' | 'authority' | 'people'
    - `event_type` string
    - `headline` string
    - `field_name` string, nullable
    - `old_value` string, nullable
    - `new_value` string, nullable
    - `metadata` object, nullable
    - `source` string

## Other responses

- `401` — Invalid or missing API key
- `404` — Carrier does not exist
- `429` — Too many requests. Check X-RateLimit-Remaining and Retry-After headers.

---

[API](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) · [All operations](https://skmtc.net/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runalphaloops/alphaloops-fmcsa-carrier-data-api/versions/dcfdb73e5778/schema)