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

# History

> Retrieve a vehicle's status changes over time, newest first.

A vehicle's `active` flag tells you where it stands today. This endpoint tells you where it stood at
any past moment, which is what you need when deciding whether a toll happened while the vehicle was
still on your fleet. Vehicles do get deactivated and brought back, so the current flag can't answer
that on its own.

Each entry is one revision: when it changed, whether the vehicle was on your fleet at that point, and
who made the change.

Entries cover every recorded change to a vehicle, not only the ones that moved it on or off the
fleet, so consecutive entries can carry the same `active` value.

## Status at a point in time

Ask for the newest revision at or before the moment you care about, then read its `active` value:

```
GET /v2/vehicles/{id}/history/?history_date__lte=2026-08-06T03:52:40Z&limit=1
```

An empty result means nothing was recorded before that moment, so the vehicle's history starts later.

<Info>
  History starts on 3 June 2023, when revision tracking was added. Vehicles deactivated before then
  have no entries, and a lookup for an earlier moment comes back empty rather than reporting a value.
</Info>


## OpenAPI

````yaml get /v2/vehicles/{id}/history/
openapi: 3.0.3
info:
  title: Fleet IT Customer API
  version: 2.0.0
  description: >-
    Public API for Fleet IT platform customers.


    For detailed guides, authentication setup, error codes, and integration
    examples, see the [Fleet IT
    Documentation](https://docs.fleetit.com/documentation/overview).


    ## Headers


    All authenticated endpoints accept an optional `Fleet-Id` header (integer)
    to specify which fleet to operate on. If omitted, the user's default fleet
    is used.
servers: []
security:
  - JWT: []
  - APIKey: []
externalDocs:
  url: https://docs.fleetit.com/documentation/overview
  description: Fleet IT Documentation
paths:
  /v2/vehicles/{id}/history/:
    get:
      tags:
        - Vehicles
      description: |-
        Return a vehicle's audit trail, newest revision first.

        The current `active` flag only says what a vehicle is now. Billing needs
        what it was at a given moment — a vehicle can be deactivated and brought
        back — so this exposes every status transition with its timestamp.
      operationId: v2_vehicles_history_list
      parameters:
        - description: Keep only revisions where the vehicle was (in)active.
          in: query
          name: active
          schema:
            type: boolean
        - description: Only revisions recorded at or after this moment.
          in: query
          name: history_date__gte
          schema:
            type: string
            format: date-time
        - description: Only revisions recorded at or before this moment.
          in: query
          name: history_date__lte
          schema:
            type: string
            format: date-time
        - description: Created, changed or deleted.
          in: query
          name: history_type
          schema:
            items:
              enum:
                - +
                - '-'
                - '~'
              type: string
            type: array
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this vehicle.
          required: true
        - name: limit
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: offset
          required: false
          in: query
          description: The initial index from which to return the results.
          schema:
            type: integer
        - in: query
          name: status_with_toll_authority
          schema:
            type: array
            items:
              type: string
              enum:
                - EXIST
                - PENDING
                - REMOVED
                - REQUESTED_REMOVAL
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedVehicleHistoryList'
          description: ''
components:
  schemas:
    PaginatedVehicleHistoryList:
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          items:
            $ref: '#/components/schemas/VehicleHistory'
          type: array
      required:
        - count
        - results
      type: object
    VehicleHistory:
      description: >-
        One row of a vehicle's audit trail.


        Reads HistoricalVehicle, not Vehicle. ``VehicleViewSet.history`` defers
        every

        column this reads, so a field added here needs adding there too or it

        re-fetches the row it was deferred from, once per result.


        Reports membership as the same ``active`` boolean the vehicle endpoints
        use.

        status_with_toll_authority stays internal: it names toll-authority

        registration states that mean nothing outside our E-ZPass plumbing, and
        no

        other customer-facing response exposes it.
      properties:
        active:
          type: boolean
          readOnly: true
        history_date:
          type: string
          format: date-time
          readOnly: true
        history_id:
          type: integer
          readOnly: true
        history_type:
          allOf:
            - $ref: '#/components/schemas/HistoryTypeEnum'
          readOnly: true
        reason:
          type: string
          readOnly: true
        username:
          type: string
          readOnly: true
      required:
        - active
        - history_date
        - history_id
        - history_type
        - reason
        - username
      type: object
    HistoryTypeEnum:
      description: |-
        * `+` - Created
        * `~` - Changed
        * `-` - Deleted
      enum:
        - +
        - '~'
        - '-'
      type: string
  securitySchemes:
    JWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
    APIKey:
      type: apiKey
      in: header
      name: Authorization

````