# Vehicle Stats snapshot

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/vehicles/stats/:
    get:
      summary: Vehicle Stats snapshot
      deprecated: false
      description: Returns the last known stats of all vehicles.
      operationId: vehicles_stats_retrieve
      tags:
        - Vehicle Stats
        - Vehicle Stats
      parameters:
        - name: vehicleIds
          in: query
          description: ''
          required: true
          schema:
            type: array
            items:
              type: string
              format: uuid
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VehicleSResponse'
              examples:
                VehicleStatsResponse:
                  summary: Vehicle Stats Response
                  value:
                    results:
                      - vehicle: 770e8400-e29b-41d4-a716-446655440002
                        driver: 660e8400-e29b-41d4-a716-446655440001
                        odometer: 125000.5
                        engine_hours: 5000
                        fuel_level: 75
                        speed: 0
                        dtc:
                          - bus: j1939
                            code: 0000007F
                            description: 'SPN: 0 – Unidentified FMI: 0 Count: 127'
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: Vehicle Stats
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/586350/apis/api-8318764-run
components:
  schemas:
    VehicleSResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/VehicleStats'
      required:
        - results
      x-apidog-orders:
        - results
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    VehicleStats:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: ID Vehicle State
        vehicle:
          type: string
          description: Vehicle UUID
        driver:
          type: string
          description: Driver UUID
        is_seat_belt_fastened:
          type: boolean
          nullable: true
        speed:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          description: Speed Vehicle
          nullable: true
        engine_check_light:
          type: boolean
          description: Engine check light indicator True/False
          readOnly: true
        oil_level:
          type: number
          format: double
          nullable: true
        oil_pressure:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        oil_temp:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        coolant_level:
          type: number
          format: double
          nullable: true
        coolant_temp:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        fuel_level:
          type: number
          format: double
          nullable: true
        fuel_level2:
          type: number
          format: double
          nullable: true
        engine_fuel_rate:
          type: number
          format: double
          nullable: true
        ambient_temperature:
          type: number
          format: double
          nullable: true
        odometer:
          type: number
          format: double
          description: Total odometer in kilometers
        engine_hours:
          type: number
          format: double
          description: Engine Hours
        bus:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        is_odometer_computed:
          type: boolean
        is_engine_hours_computed:
          type: boolean
        gear:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        engine_rpm:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        intake_temperature:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        fuel_tank_temperature:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        intercooler_temperature:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        turbo_oil_temperature:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        transmission_oil_temperature:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        engine_load:
          type: number
          format: double
          nullable: true
        def_level_percent:
          type: number
          format: double
          nullable: true
        engine_fuel_economy:
          type: number
          format: double
          nullable: true
        ambient_pressure:
          type: number
          format: double
          nullable: true
        total_engine_idle_time:
          type: number
          format: double
          nullable: true
        total_pto_time:
          type: number
          format: double
          nullable: true
        total_engine_idle_fuel:
          type: number
          format: double
          nullable: true
        total_fuel_used:
          type: number
          format: double
          nullable: true
        brake_pedal:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          nullable: true
        intake_pressure:
          type: number
          format: double
          nullable: true
        retarder_percent:
          type: number
          format: double
          nullable: true
        dtc:
          type: object
          additionalProperties:
            type: string
          description: DTC (Diagnostic Trouble Codes)
          x-apidog-orders: []
          properties: {}
          x-apidog-ignore-properties: []
          nullable: true
      required:
        - id
        - vehicle
        - driver
        - engine_check_light
        - odometer
        - engine_hours
        - dtc
      x-apidog-orders:
        - id
        - vehicle
        - driver
        - is_seat_belt_fastened
        - speed
        - engine_check_light
        - oil_level
        - oil_pressure
        - oil_temp
        - coolant_level
        - coolant_temp
        - fuel_level
        - fuel_level2
        - engine_fuel_rate
        - ambient_temperature
        - odometer
        - engine_hours
        - bus
        - is_odometer_computed
        - is_engine_hours_computed
        - gear
        - engine_rpm
        - intake_temperature
        - fuel_tank_temperature
        - intercooler_temperature
        - turbo_oil_temperature
        - transmission_oil_temperature
        - engine_load
        - def_level_percent
        - engine_fuel_economy
        - ambient_pressure
        - total_engine_idle_time
        - total_pto_time
        - total_engine_idle_fuel
        - total_fuel_used
        - brake_pedal
        - intake_pressure
        - retarder_percent
        - dtc
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.firsteld.com
    description: Prod Env
security: []

```