> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Changes

> Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Returns published changes. A watchlist_id filter additionally requires watchlists:read. Insurance events are visible only with insurance:read and insurance availability. Preserve selection filters with cursors; store events and deduplicate IDs before advancing the resume cursor.



## OpenAPI

````yaml /openapi.json get /changes
openapi: 3.1.1
info:
  title: TruckerFetch Pro API
  version: 1.0.0
  description: >-
    Owner-scoped carrier, authority and observed-insurance research. All data
    operations require active Pro. Additional scopes, historical grants, source
    availability and current suppressions apply. Source observation, effective
    dates, edition dates and renewal estimates represent distinct facts.
servers:
  - url: https://truckerfetch.com/api/v1
security: []
paths:
  /changes:
    get:
      summary: List Changes
      description: >-
        Requires active Pro and an owner-scoped REST bearer key. Required
        scopes: data:read. Returns published changes. A watchlist_id filter
        additionally requires watchlists:read. Insurance events are visible only
        with insurance:read and insurance availability. Preserve selection
        filters with cursors; store events and deduplicate IDs before advancing
        the resume cursor.
      operationId: listChanges
      parameters:
        - in: query
          name: cursor
          schema:
            type: string
            maxLength: 1800
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - in: query
          name: usdot
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            type: string
            pattern: ^[0-9]{1,16}$
            description: >-
              A nonzero USDOT identifier as a string; leading zeroes are
              normalized by the service.
        - in: query
          name: since
          schema:
            type: string
            format: date-time
        - in: query
          name: event_types
          schema:
            type: string
            maxLength: 300
          description: Comma-separated published event types.
        - in: query
          name: watchlist_id
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Authorized operation result
          headers:
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data: {}
                  meta:
                    type: object
                  next_cursor:
                    type: string
        '400':
          description: Invalid request
        '401':
          description: Credential required
        '402':
          description: Active Pro required
        '403':
          description: Insufficient scope or allowance
        '404':
          description: Unknown or inaccessible resource
        '409':
          description: >-
            Idempotency conflict, changed projection or owner confirmation
            required
        '410':
          description: >-
            Expired cursor, artifact or dated edition outside the rolling 90-day
            Lead History window (archive_expired); the latest published edition
            remains available
        '429':
          description: Request limit exceeded
          headers:
            Retry-After:
              schema:
                type: string
        '503':
          description: Service or binding unavailable
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Owner-scoped Pro API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.