---
title: "Get the monitoring change history for a carrier"
method: GET
path: "/monitoring/carriers/{dotNumber}/changes"
tags: ["Carrier Hub"]
---

# Get the monitoring change history for a carrier

`GET /monitoring/carriers/{dotNumber}/changes`

## Request

- Base URL: `http://api.truckstop.com/carrierhub/v1`
- URL: `http://api.truckstop.com/carrierhub/v1/monitoring/carriers/{dotNumber}/changes`
- Auth: HTTP bearer

Returns the modules that changed for the given DOT, and when, since the given cursor or datetime. cursor takes precedence when both are given.

## Query parameters

- `cursor` string
- `since` string, date-time
- `modules` ExternalModule[]
- `limit` integer

## Response `200`

Modules changed for the given DOT since the given cursor or datetime.

- MonitoringCarrierChanges: The modules that changed for a single DOT, and when, since a given cursor or datetime.
  - `changes` MonitoringCarrierChange[], required
    - `module` 'Demographics' | 'Authority' | 'Insurance' | 'Safety' | 'Reputation', required: One of the data modules that can be requested for a monitored carrier.
    - `eventType` 'ADDED' | 'UPDATED' | 'DELETED', required: The kind of change that occurred to a monitored module.
    - `updatedAt` string, date-time, required: When this change occurred.
  - `cursor` string, required: Opaque cursor for this response. Pass back as the next request's cursor param to get only changes after this point.

## Other responses

- `400`: There was a problem with the data provided for this request.
- `401`: Authorization was denied for this request.
- `404`: The requested resource was not found.
- `499`: The request was closed by the client before the server could respond.
- `500`: A server side error occurred.

---

[API](https://skmtc.dev/truckstop/apis/carrierhub.md) - [All operations](https://skmtc.dev/truckstop/apis/carrierhub/llms.txt) - [OpenAPI document](https://skmtc.dev/truckstop/apis/carrierhub/revisions/a5d988fae489?raw)