Carrier Lynx Fleet API

openapi: 3.0.0
components:
  schemas:
    BadRequestError:
      type: object
      properties:
        message:
          type: string
          description: >-
            The request was unacceptable, often due to missing a required
            parameter
          example: No match found
    AuthRequestError:
      type: object
      properties:
        message:
          type: string
          description: No valid API key provided
          example: Unauthorized
    ForbiddenRequestError:
      type: object
      properties:
        message:
          type: string
          description: The API key doesn't have permissions to perform the request
          example: Access to the requested resource is forbidden
    TooManyRequestsError:
      type: object
      properties:
        message:
          type: string
          description: >-
            Too many requests hit the API too quickly. We recommend exponential
            backoff of your requests
          example: Too Many Requests
    UnexpectedError:
      type: object
      properties:
        message:
          type: string
          description: Something went wrong on Stripe's end
          example: Server Error
    Asset:
      type: object
      required:
        - assetId
      description: Represents all information about an asset.
      properties:
        assetId:
          type: string
          description: Lynx system unique Asset identifier
          readOnly: true
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
        assetName:
          type: string
          description: Asset name
          example: Sample Asset
        licensePlateNumber:
          type: string
          description: Asset License Plate
          example: '1099176'
        assetType:
          type: string
          description: Asset Type
        customFields:
          type: array
          nullable: true
          description: User Defined custom fields for the asset
          items:
            $ref: '#/components/schemas/CustomFieldsValues'
        status:
          type: string
          example: moving
          readOnly: true
          description: Asset moving status
          nullable: true
          enum:
            - stop
            - moving
        truSerialNumber:
          type: string
          description: Transport Refrigeration Unit - Serial Number
          example: HD12345
        truModelNumber:
          type: string
          description: Transport Refrigeration Unit - Model Number
          example: KSK123K
        truControlSystemType:
          type: string
          description: Transport Refrigeration Unit - Control System Type
          example: APX
        truSoftwareVersion:
          type: string
          readOnly: true
          description: Transport Refrigeration Unit - Software Version
          example: 7.72.00
        createdDate:
          type: string
          format: date-time
          example: '2016-08-29T09:12:33.001Z'
          readOnly: true
          description: Asset creation date
        tenantId:
          type: string
          format: uuid
          nullable: true
          description: Asset Company ID
          example: a7f39dec-ca34-47d3-97a7-66bcfda0396b
        tenantName:
          type: string
          description: Asset Company Name
          example: Sample Company
        deviceId:
          type: string
          format: uuid
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
          description: Telematics Device ID in Lynx system
        sensorConfiguration:
          type: array
          nullable: true
          description: Device Sensor configurations
          items:
            $ref: '#/components/schemas/Sensor'
    AssetList:
      type: object
      description: List of Asset objects
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
        total:
          type: integer
          example: 20
          description: Total number of items that match the request
        nextToken:
          type: string
          description: A pagination token used to return a set of results
    AssetBatteryList:
      type: object
      description: List of Asset Battery objects
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/AssetBattery'
        total:
          type: integer
          example: 20
          description: Total number of items that match the request
        nextToken:
          type: string
          description: A pagination token used to return a set of results
    AssetBatteryHistory:
      type: object
      description: List of Asset history objects
      properties:
        data:
          type: object
          properties:
            AssetInfo:
              $ref: '#/components/schemas/AssetBatteryInfo'
            BatteryEvents:
              $ref: '#/components/schemas/BatteryEvents'
        nextToken:
          type: string
          description: A pagination token used to return a set of results
    BatteryEvent:
      type: object
      description: Represents historical battery event
      properties:
        eventDateTimeUTC:
          type: string
          format: date-time
          example: '2016-08-29T09:12:33.001Z'
          description: >-
            Date and time that the message was collected by the telematics
            device
        lowBatterySince:
          type: string
          format: date-time
          example: '2016-08-29T09:12:33.001Z'
          description: Date and time from when the battery soc was low
        truPowerStatus:
          type: string
          example: grid
          readOnly: true
          description: >-
            Power status indicating if the TRU power is connected to grid or
            battery
          nullable: true
          enum:
            - grid
            - battery
        truSerialNumber:
          type: string
          description: Transport Refrigeration Unit - Serial Number
          example: HD12345
        stateOfCharge:
          type: number
          description: battery unit state of charge
          example: 90
        chargingStatus:
          type: string
          description: battery charging status
          nullable: true
          example: Charging (Axle)
          enum:
            - Inactive
            - Charging (Axle)
            - Charging (Grid)
            - In Use
        batteryLastSeen:
          type: string
          format: date-time
          example: '2023-04-24T09:12:33.001Z'
          description: Last update event recieved from battery unit
          nullable: true
        batteryLastRebalance:
          type: string
          format: date-time
          example: '2016-04-25T09:12:33.001Z'
          description: last time when the battery is fully charged
          nullable: true
        batteryTemperatureMin:
          type: number
          example: 25
          description: Recent battery minimum temperature noted
        batteryTemperatureMax:
          type: number
          example: 40
          description: Recent battery maximum temperature noted
        isAlarm73Active:
          type: boolean
          description: Indicates if alarm is active or not
          example: false
    BatteryEvents:
      type: array
      description: An array containing battery event objects.
      items:
        $ref: '#/components/schemas/BatteryEvent'
    BatteryHistoryEntry:
      type: object
      description: ''
      properties:
        AssetInfo:
          $ref: '#/components/schemas/AssetBatteryInfo'
        BatteryEvents:
          $ref: '#/components/schemas/BatteryEvents'
    AssetBatteryInfo:
      type: object
      description: Represents basic info about Asset
      properties:
        assetId:
          type: string
          description: Lynx system unique Asset identifier
          readOnly: true
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
        assetName:
          type: string
          description: Asset name
          example: Sample Asset
        truSerialNumber:
          type: string
          description: Transport Refrigeration Unit - Serial Number
          example: HD123456
    AssetParamWithId:
      type: object
      required:
        - assetId
      properties:
        assetId:
          description: Asset id
          type: string
          example: TestAssetId
        nextToken:
          description: A pagination token used to return a set of results
          type: string
          example: AYABeCfa0bJE93-3AxGARdk1MAoAAAABAAdhd3Mta21zAEt
          minLength: 1
          maxLength: 2048
      example:
        assetId: TestAssetId
    AssetParamWithName:
      type: object
      required:
        - assetName
      properties:
        assetName:
          description: Asset name
          type: string
          example: TestAssetName
        nextToken:
          description: A pagination token used to return a set of results
          type: string
          example: AYABeCfa0bJE93-3AxGARdk1MAoAAAABAAdhd3Mta21zAEt
          minLength: 1
          maxLength: 2048
      example:
        assetName: TestAssetName
    AssetParamWithTruSerialNumber:
      type: object
      required:
        - truSerialNumber
      properties:
        truSerialNumber:
          description: TRU serial number
          type: string
          example: TestTruSerialNumber
        nextToken:
          description: A pagination token used to return a set of results
          type: string
          example: AYABeCfa0bJE93-3AxGARdk1MAoAAAABAAdhd3Mta21zAEt
          minLength: 1
          maxLength: 2048
      example:
        truSerialNumber: TestTruSerialNumber
    AssetParamWithLicensePlateNumber:
      type: object
      required:
        - licensePlateNumber
      properties:
        licensePlateNumber:
          description: License Plate Number
          type: string
          example: TestLicensePlateNumber
        nextToken:
          description: A pagination token used to return a set of results
          type: string
          example: AYABeCfa0bJE93-3AxGARdk1MAoAAAABAAdhd3Mta21zAEt
          minLength: 1
          maxLength: 2048
      example:
        licensePlateNumber: TestLicensePlateNumber
    Sensor:
      type: object
      description: Information about sensor configuration status
      properties:
        sensorType:
          type: string
          example: AIN4
          enum:
            - NONE
            - AIN1
            - AIN2
            - AIN3
            - AIN4
            - DIN1
            - DIN1_DATACOLD
            - DIN2
            - DIN2_DATACOLD
            - DIN3
            - DIN3_DATACOLD
            - DIN4
            - DIN4_DATACOLD
            - BT_EN12830
          description: Type of the sensor
        configured:
          type: boolean
          description: Indication if sensor is configured or not
          example: true
        sensorLocation:
          type: string
          nullable: true
          description: >-
            Installation location (Side Door, Rear Door) [Applicable only to
            door sensors]
          enum:
            - NONE
            - SIDE
            - REAR
            - RAS1
            - RAS1_DATACOLD
            - RAS2
            - RAS2_DATACOLD
            - RAS3
            - RAS3_DATACOLD
            - SAS1
            - SAS1_DATACOLD
            - SAS2
            - SAS2_DATACOLD
            - SAS3
            - SAS3_DATACOLD
            - BOX1
            - BOX1_DATACOLD
            - BOX2
            - BOX2_DATACOLD
            - BOX3
            - BOX3_DATACOLD
          example: RAS1
        connectionLocation:
          type: string
          example: Telematics device | TRU Controller
          description: Device that the sensor is connected to
        sensorData:
          type: string
          nullable: true
          description: Sensor value
          example: '48.577778'
    AssetHistoryEntry:
      type: object
      description: Represents telematics data of the device in the concrete period of time
      properties:
        eventDateTimeUTC:
          type: string
          format: date-time
          example: '2016-08-29T09:12:33.001Z'
          description: >-
            Date and time that the message was collected by the telematics
            device
        assetInfo:
          $ref: '#/components/schemas/AssetInfo'
        statusInfo:
          $ref: '#/components/schemas/StatusInfo'
        temperatureInfo:
          $ref: '#/components/schemas/TemperatureInfo'
        positionInfo:
          $ref: '#/components/schemas/PositionInfo'
        alarmInfo:
          $ref: '#/components/schemas/AlarmInfo'
        commandInfo:
          $ref: '#/components/schemas/CommandInfo'
        sensorConfiguration:
          type: array
          nullable: true
          description: Device Sensor configurations
          items:
            $ref: '#/components/schemas/Sensor'
        connectedTruckInfo:
          $ref: '#/components/schemas/ConnectedTruckInfo'
    MultiAssetHistoryEntry:
      type: object
      description: Represents telematics data of the device in the concrete period of time
      properties:
        eventDateTimeUTC:
          type: string
          format: date-time
          example: '2016-08-29T09:12:33.001Z'
          description: >-
            Date and time that the message was collected by the telematics
            device
        assetInfo:
          $ref: '#/components/schemas/AssetInfo'
        statusInfo:
          $ref: '#/components/schemas/StatusInfo'
        temperatureInfo:
          $ref: '#/components/schemas/TemperatureInfo'
        positionInfo:
          $ref: '#/components/schemas/PositionInfo'
        alarmInfo:
          $ref: '#/components/schemas/AlarmInfo'
        commandInfo:
          $ref: '#/components/schemas/CommandInfo'
        sensorConfiguration:
          type: array
          nullable: true
          description: Device Sensor configurations
          items:
            $ref: '#/components/schemas/Sensor'
        connectedTruckInfo:
          $ref: '#/components/schemas/ConnectedTruckInfo'
    MultiAssetHistoryItem:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MultiAssetHistoryEntry'
        nextToken:
          type: string
          description: A pagination token used to return a set of results
    AssetInfo:
      type: object
      description: Represents all information about an asset.
      properties:
        assetId:
          type: string
          description: Lynx system unique Asset identifier
          readOnly: true
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
        assetName:
          type: string
          description: Asset name
          example: Sample Asset
        deviceId:
          type: string
          description: Telematics Device ID in Lynx system
          format: uuid
          example: 8d8a8b5a-6069-41ad-85b7-a037ee62660d
        createdDate:
          type: string
          description: Creation date
          format: date-time
          example: '2024-10-22T09:13:22.212Z'
        licensePlateNumber:
          type: string
          description: Asset License Plate
          example: '1099176'
        assetType:
          type: string
          description: Asset Type
        customFields:
          type: array
          nullable: true
          description: User Defined custom fields for the asset
          items:
            $ref: '#/components/schemas/CustomFieldsValues'
        status:
          type: string
          description: Asset moving status
          example: moving
        tenantId:
          type: string
          description: Asset Company ID
          format: uuid
          example: a7f39dec-ca34-47d3-97a7-66bcfda0396b
        tenantName:
          type: string
          description: Asset Company Name
          example: TestCompany
        truSerialNumber:
          type: string
          description: Transport Refrigeration Unit - Serial Number
          example: HD12345
        truModelNumber:
          type: string
          description: Transport Refrigeration Unit - Model Number
          example: KSK378N6LF1
        truControlSystemType:
          type: string
          description: Transport Refrigeration Unit - Control System Type
          example: APX
        truSoftwareVersion:
          type: string
          readOnly: true
          example: 4.79.00
          description: Transport Refrigeration Unit - Software Version
    StatusInfo:
      type: object
      description: >-
        An object containing information about the state of the Transport
        Refrigeration Unit at the time of the message.
      properties:
        powerStatus:
          type: string
          description: Transport Refrigeration Unit Power Status (On or Off)
          example: 'off'
        switchOnHours:
          type: number
          description: >-
            The total accumulated hours that the Transport Refrigeration Unit
            has been turned on.
          example: 859
        engineRunHours:
          type: number
          description: >-
            The total accumulated hours that the Transport Refrigeration Unit
            has been running on its engine.
          example: 4
        batteryVoltage:
          type: number
          example: 12.9
          description: The voltage of the Transport Refrigeration Unit's 12V battery.
        batteryCurrent:
          type: number
          example: 0.05
          description: Battery Current (Device).
        deviceBatteryPowerSupply:
          type: number
          example: 2.05
          description: Battery Power Supply (Device).
        deviceBatteryVoltage:
          type: number
          example: 3.01
          description: Battery Voltage of the Device.
        rearDoorOpen:
          type: boolean
          description: Indicates if the rear door on the truck or trailer is open or not.
          example: false
        sideDoorOpen:
          type: boolean
          description: Indicates if the side door on the truck or trailer is open or not.
          example: false
        fuelLevel:
          type: number
          description: Transport Refrigeration Unit Fuel Level (%).
          example: 20
        truStatus:
          type: string
          description: Overall Status of the Transport Refrigeration Unit.
          enum:
            - 'OFF'
            - 'ON'
          example: 'ON'
        comp1OperatingMode:
          type: string
          description: Operating mode of Compartment 1.
          example: Heat
        comp2OperatingMode:
          type: string
          description: Operating mode of Compartment 2.
          example: Off,  (compartment Off due to engine off)
        comp3OperatingMode:
          type: string
          description: Operating mode of Compartment 3.
          example: Off,  (compartment Off due to engine off)
        comp1Status:
          type: boolean
          description: On/Off Status of Compartment 1.
          example: true
        comp2Status:
          type: boolean
          description: On/Off Status of Compartment 2.
          example: true
        comp3Status:
          type: boolean
          description: On/Off Status of Compartment 3.
          example: false
        positionSpeed:
          type: number
          description: Speed of the unit at the time of the message.
          example: 0
        vehicleMileage:
          type: number
          description: Mileage of the unit at the time of the message.
          example: 5
        standByHours:
          type: number
          description: >-
            The total accumulated hours that the Transport Refrigeration Unit
            has been running on stand by, or electric, power.
          example: 150
        movementStatus:
          type: boolean
          description: Indicates if the unit is moving or not.
          example: false
        enginePowerMode:
          type: string
          description: Transport Refrigeration Unit Power Source (Engine or Standby).
          enum:
            - Standby
            - Engine
          example: Standby
        engineControlMode:
          type: string
          description: Transport Refrigeration Unit Control Mode.
          enum:
            - Continuous
            - Start/Stop
          example: Continuous
        engineSpeed:
          type: string
          description: Transport Refrigeration Unit Engine Speed.
          enum:
            - Engine speed High
            - Engine speed Low
            - Engine speed very Low
            - Engine speed very High
          example: Engine speed High
        switchKeyStatus:
          type: boolean
          example: true
          description: Lcv switch key status.
        roadEnergy:
          type: number
          example: 123
          description: Lcv road energy.
        standByEnergy:
          type: number
          example: 13
          description: Lcv standBy Energy.
        powerMode:
          type: number
          example: 15
          description: Lcv power mode.
    TemperatureInfo:
      type: object
      description: >-
        An object containing information about the temperature recordings at the
        time of the message.
      properties:
        setpointTemp1:
          type: number
          description: Compartment 1 Setpoint Temperature (°C)
          example: -30
        setpointTemp2:
          type: number
          description: Compartment 2 Setpoint Temperature (°C)
          example: 1
        setpointTemp3:
          type: number
          description: Compartment 3 Setpoint Temperature (°C)
          example: 2
        returnAirTemp1:
          type: number
          description: Compartment 1 Return Air Temperature (°C)
          example: 6.7
        returnAirTemp2:
          type: number
          description: Compartment 2 Return Air Temperature (°C)
          example: 15.8
        returnAirTemp3:
          type: number
          description: Compartment 3 Return Air Temperature (°C)
          example: 2.2
        supplyAirTemp1:
          type: number
          description: Compartment 1 Supply Air Temperature (°C)
          example: 13.3
        supplyAirTemp2:
          type: number
          description: Compartment 2 Supply Air Temperature (°C)
          example: 16.2
        supplyAirTemp3:
          type: number
          description: Compartment 3 Supply Air Temperature (°C)
          example: 4.1
        datacoldTemp1:
          type: number
          description: DataCOLD temperature sensor 1
          example: 1.1
        datacoldTemp2:
          type: number
          description: DataCOLD temperature sensor 2
          example: 2.2
        datacoldTemp3:
          type: number
          description: DataCOLD temperature sensor 3
          example: 2.1
        datacoldTemp4:
          type: number
          description: DataCOLD temperature sensor 4
          example: 3.4
        datacoldTemp5:
          type: number
          description: DataCOLD temperature sensor 5
          example: 1.9
        datacoldTemp6:
          type: number
          description: DataCOLD temperature sensor 6
          example: 3.1
        bluetoothTemp1:
          type: number
          description: Bluetooth temperature sensor 1
          example: 3.1
        bluetoothTemp2:
          type: number
          description: Bluetooth temperature sensor 2
          example: 2.2
        bluetoothTemp3:
          type: number
          description: Bluetooth temperature sensor 3
          example: 1.8
        bluetoothTemp4:
          type: number
          description: Bluetooth temperature sensor 4
          example: 4.1
        bluetoothTemp5:
          type: number
          description: Bluetooth temperature sensor 5
          example: 1.1
        bluetoothTemp6:
          type: number
          description: Bluetooth temperature sensor 6
          example: 5.1
        oneWireTemp1:
          type: number
          description: One Wire temperature sensor 1
          example: 2.5
        oneWireTemp2:
          type: number
          description: One Wire temperature sensor 2
          example: 7.2
        oneWireTemp3:
          type: number
          description: One Wire temperature sensor 3
          example: 2.9
        oneWireTemp4:
          type: number
          description: One Wire temperature sensor 4
          example: 4.4
        oneWireTemp5:
          type: number
          description: One Wire temperature sensor 5
          example: 2.4
        oneWireTemp6:
          type: number
          description: One Wire temperature sensor 6
          example: 1.5
    PositionInfo:
      type: object
      description: >-
        An object containing information about the location of the asset at the
        time of the message.
      properties:
        lat:
          type: string
          example: 51.61341
          description: Latitude coordinate value
        long:
          type: string
          example: 5.508494
          description: Longitude coordinate value
    Alarm:
      type: object
      description: >-
        An object containing information about any Transport Refrigeration Unit
        alarms at the time of the message.
      properties:
        response:
          type: string
          example: Shut Down
          description: Alarm type
        code:
          type: string
          example: 246
          description: Alarm code
        description:
          type: string
          description: Alarm description
          example: Eprom Write Failure
    AlarmInfo:
      type: array
      description: >-
        An array containing AlarmInfo objects, which contains information about
        any Transport Refrigeration Unit alarms at the time of the message.
      items:
        $ref: '#/components/schemas/Alarm'
    ConnectedTruckInfo:
      type: object
      description: >-
        An array containing ConnectedTruckInfo objects, which contain
        information about signal strength, licensePlate number, macId and
        truckName.
      properties:
        truckName:
          type: string
          example: DevBeacon14
          description: Truck Name
        licensePlateNumber:
          type: string
          example: HF759B4
          description: license Plate Number
        signalStrength:
          type: number
          example: 15
          description: Signal Strength
        macId:
          type: string
          example: 7CD9F41E90B4
          description: Mac ID
    CustomFieldsValues:
      type: object
      description: User Defined custom fields CustomFieldsValues
      properties:
        fieldId:
          type: string
          format: uuid
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
          description: Refernce for user defined cusstom field
        label:
          type: string
          description: Label for the user defined custom field
        value:
          type: string
          description: Label for the user defined custom field
        type:
          type: string
          description: type for the custom field
    AssetHistoryList:
      type: object
      description: List of Asset history objects
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/AssetHistoryEntry'
        total:
          type: integer
          example: 20
          description: Total number of items that match the request
        nextToken:
          type: string
          description: A pagination token used to return a set of results
    MultiAssetHistory:
      type: array
      description: Multi Asset History
      items:
        $ref: '#/components/schemas/MultiAssetHistoryItem'
    MultiAssetHistoryRequest:
      type: object
      required:
        - startDate
        - endDate
        - assets
      properties:
        assets:
          description: >-
            Array of asset ids (could be mixed with assetNames and/or
            truSerialNumbers and/or licensePlateNumbers) with optional
            nextToken. Requests are limited to 10 asset ids
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/AssetParamWithId'
              - $ref: '#/components/schemas/AssetParamWithName'
              - $ref: '#/components/schemas/AssetParamWithTruSerialNumber'
              - $ref: '#/components/schemas/AssetParamWithLicensePlateNumber'
          example:
            - assetId: TestAssetIdAsset1
              nextToken: AYABeCfa0bJE93-3AxGARdk1MAoAAAABAAdhd3Mta21zAEt
            - assetId: TestIdAsset2
            - assetName: TestAssetNameAsset3
            - truSerialNumber: TestAssetTruSerialNumberAsset4
            - licensePlateNumber: TestLicensePlateNumberAsset5
        startDate:
          description: >-
            Return data after this input. UTC date in ISO Date Time Format
            yyyy-MM-dd'T'HH:mm:ssZ. startDate - endDate range cannot exceed 1
            day
          type: string
          format: date-time
          example: '2019-05-17T08:30:00Z'
        endDate:
          description: >-
            Return data before this input. UTC date in ISO Date Time Format
            yyyy-MM-dd'T'HH:mm:ssZ. startDate - endDate range cannot exceed 1
            day
          type: string
          format: date-time
          example: '2019-05-17T08:30:00Z'
        limit:
          description: The number of items to return
          type: integer
          minimum: 1
          maximum: 100
    AssetSnapshot:
      type: object
      description: Represents telematics data of the device in concrete period of time
      properties:
        eventDateTimeUTC:
          type: string
          format: date-time
          example: '2016-08-29T09:12:33.001Z'
          description: >-
            Date and time that the last message for the referenced asset was
            collected by the telematics device
        assetInfo:
          $ref: '#/components/schemas/Asset'
        statusInfo:
          $ref: '#/components/schemas/StatusInfo'
        temperatureInfo:
          $ref: '#/components/schemas/TemperatureInfo'
        positionInfo:
          $ref: '#/components/schemas/PositionInfo'
        alarmInfo:
          $ref: '#/components/schemas/AlarmInfo'
        connectedTruckInfo:
          $ref: '#/components/schemas/ConnectedTruckInfo'
    AssetSnapshotList:
      type: object
      description: List of Asset snapshot objects
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/AssetSnapshot'
        total:
          type: integer
          example: 20
          description: Total number of items that match the request
        nextToken:
          type: string
          description: A pagination token used to return a set of results
    AssetBattery:
      type: object
      required:
        - assetId
      description: Represents all information about asset
      properties:
        assetId:
          type: string
          description: Lynx system unique Asset identifier
          readOnly: true
          example: b1ac42db-3574-4d1c-aaa3-db1f669f693a
        assetName:
          type: string
          description: Asset name
          example: sample_asset
        truStatus:
          type: string
          example: 'ON'
          description: Tru unit status
          nullable: true
          enum:
            - 'ON'
            - 'OFF'
        truPowerStatus:
          type: string
          example: grid
          readOnly: true
          description: >-
            Power status indicating if the TRU power is connected to grid or
            battery
          nullable: true
          enum:
            - grid
            - battery
        truSerialNumber:
          type: string
          description: Transport Refrigeration Unit - Serial Number
          example: HD12345
        stateOfCharge:
          type: number
          description: battery unit state of charge
          example: 90
        chargingStatus:
          type: string
          description: battery charging status
          nullable: true
          enum:
            - Inactive
            - Charging (Axle)
            - Charging (Grid)
            - In Use
          example: Inactive
        batteryLastSeen:
          type: string
          format: date-time
          example: '2023-04-24T09:12:33.001Z'
          description: Last update event recieved from battery unit
          nullable: true
        ba

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/carrier-global/refs/heads/main/openapi/carrier-global-lynx-fleet-api-openapi.yaml