---
title: "Get history query item"
method: GET
path: "/api/history/{historyId}/items/{itemId}"
tags: ["History Queries"]
---

# Get history query item

`GET /api/history/{historyId}/items/{itemId}`

Retrieves a specific item from a history query

## Path parameters

- `historyId` string, required
- `itemId` string, required

## Response `200`

The history query item

- union — Data Transfer Object for a history query item. Represents an individual data point to be queried.
  - HistoryQueryADSItemDTO — History query item DTO for Beckhoff ADS.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthADSItemSettings, required
      - `address` string, required
  - HistoryQueryBACnetItemDTO — History query item DTO for BACnet/IP.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthBACnetItemSettings, required
      - `deviceAddress` string, required
      - `deviceInstance` number, double, required
      - `objectType` 'analog-input' | 'analog-output' | 'analog-value' | 'binary-input' | 'binary-output' | 'binary-value' | 'multi-state-input' | 'multi-state-output' | 'multi-state-value', required
      - `objectInstance` number, double, required
      - `propertyIdentifier` 'present-value' | 'status-flags' | 'reliability' | 'out-of-service' | 'units', required
  - HistoryQueryFolderScannerItemDTO — History query item DTO for the Folder Scanner.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthFolderScannerItemSettings, required
      - `regex` string, required
      - `minAge` number, double, required
      - `preserveFiles` boolean, required
      - `ignoreModifiedDate` boolean
      - `maxFiles` number, double, required
      - `maxSize` number, double, required
      - `recursive` boolean, required
  - HistoryQueryFTPItemDTO — History query item DTO for FTP file transfer.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthFTPItemSettings, required
      - `remoteFolder` string, required
      - `regex` string, required
      - `minAge` number, double, required
      - `preserveFiles` boolean, required
      - `ignoreModifiedDate` boolean
      - `maxFiles` number, double, required
      - `maxSize` number, double, required
      - `recursive` boolean, required
  - HistoryQueryInfluxDBItemDTO — History query item DTO for InfluxDB time series database.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthInfluxDBItemSettings, required
      - `query` string, required
      - `requestTimeout` number, double, required
  - HistoryQueryModbusItemDTO — History query item DTO for Modbus.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthModbusItemSettings, required
      - `address` string, required
      - `modbusType` 'coil' | 'discrete-input' | 'input-register' | 'holding-register', required
      - `data` SouthModbusItemSettingsData
        - `dataType` 'uint16' | 'int16' | 'uint32' | 'int32' | 'big-uint64' | 'big-int64' | 'float' | 'double' | 'bit', required
        - `bitIndex` number, double
        - `multiplierCoefficient` number, double, required
  - HistoryQueryMongoDBItemDTO — History query item DTO for MongoDB.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthMongoDBItemSettings, required
      - `collection` string, required
      - `queryType` 'find' | 'aggregation', required
      - `query` string, required
      - `sort` string, required
      - `trackingInstant` SouthMongoDBItemSettingsTrackingInstant, required
        - `trackInstant` boolean, required
        - `jsonPath` string
        - `dateTimeInput` SouthMongoDBItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'timestamp' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
  - HistoryQueryMQTTItemDTO — History query item DTO for MQTT.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthMQTTItemSettings, required
      - `topic` string, required
  - HistoryQueryMSSQLItemDTO — History query item DTO for Microsoft SQL Server.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthMSSQLItemSettings, required
      - `query` string, required
      - `trackingInstant` SouthMSSQLItemSettingsTrackingInstant, required
        - `trackInstant` boolean, required
        - `fieldName` string
        - `dateTimeInput` SouthMSSQLItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms' | 'date' | 'date-time' | 'date-time-2' | 'date-time-offset' | 'small-date-time', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
  - HistoryQueryMySQLItemDTO — History query item DTO for MySQL.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthMySQLItemSettings, required
      - `query` string, required
      - `requestTimeout` number, double, required
      - `trackingInstant` SouthMySQLItemSettingsTrackingInstant, required
        - `trackInstant` boolean, required
        - `fieldName` string
        - `dateTimeInput` SouthMySQLItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms' | 'date-time', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
  - HistoryQueryODBCItemDTO — History query item DTO for ODBC.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthODBCItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthODBCItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthODBCItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
  - HistoryQueryOIAnalyticsItemDTO — History query item DTO for OIAnalytics.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthOIAnalyticsItemSettings, required
      - `endpoint` string, required
      - `queryParams` SouthOIAnalyticsItemSettingsQueryParams[], required
        - `key` string, required
        - `value` string, required
      - `serialization` SouthOIAnalyticsItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
  - HistoryQueryOLEDBItemDTO — History query item DTO for OLE DB.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthOLEDBItemSettings, required
      - `query` string, required
      - `dateTimeFields` SouthOLEDBItemSettingsDateTimeFields[], nullable, required
        - `fieldName` string, required
        - `useAsReference` boolean, required
        - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
        - `timezone` string — Represents a timezone as an IANA timezone string.
        - `format` string
        - `locale` string
      - `serialization` SouthOLEDBItemSettingsSerialization, required
        - `type` 'csv', required
        - `filename` string, required
        - `delimiter` 'DOT' | 'SEMI_COLON' | 'COLON' | 'COMMA' | 'NON_BREAKING_SPACE' | 'SLASH' | 'TAB' | 'PIPE', required
        - `compression` boolean, required
        - `outputTimestampFormat` string, required
        - `outputTimezone` string, required — Represents a timezone as an IANA timezone string.
  - HistoryQueryOPCItemDTO — History query item DTO for classic OPC (OLE for Process Control).
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthOPCItemSettings, required
      - `nodeId` string, required
      - `aggregate` 'raw' | 'interpolative' | 'total' | 'average' | 'time-average' | 'count' | 'stdev' | 'minimum-actual-time' | 'minimum' | 'maximum-actual-time' | 'maximum' | 'start' | 'end' | 'delta' | 'reg-slope' | 'reg-const' | 'reg-dev' | 'variance' | 'range' | 'duration-good' | 'duration-bad' | 'percent-good' | 'percent-bad' | 'worst-quality' | 'annotations', required
      - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
  - HistoryQueryOPCUAItemDTO — History query item DTO for OPC UA.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthOPCUAItemSettings, required
      - `nodeId` string, required
      - `mode` 'da' | 'ha', required
      - `haMode` SouthOPCUAItemSettingsHaMode
        - `aggregate` 'raw' | 'average' | 'count' | 'minimum' | 'maximum', required
        - `resampling` 'none' | '1s' | '10s' | '30s' | '1min' | '1h' | '1d'
      - `timestampOrigin` 'oibus' | 'point' | 'server'
  - HistoryQueryOracleItemDTO — History query item DTO for Oracle Database.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthOracleItemSettings, required
      - `query` string, required
      - `requestTimeout` number, double, required
      - `trackingInstant` SouthOracleItemSettingsTrackingInstant, required
        - `trackInstant` boolean, required
        - `fieldName` string
        - `dateTimeInput` SouthOracleItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms' | 'date-time', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
  - HistoryQueryOsisoftPIItemDTO — History query item DTO for OSIsoft PI System.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthPIItemSettings, required
      - `type` 'point-id' | 'point-query', required
      - `piPoint` string
      - `piQuery` string
  - HistoryQueryPostgreSQLItemDTO — History query item DTO for PostgreSQL.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthPostgreSQLItemSettings, required
      - `query` string, required
      - `trackingInstant` SouthPostgreSQLItemSettingsTrackingInstant, required
        - `trackInstant` boolean, required
        - `fieldName` string
        - `dateTimeInput` SouthPostgreSQLItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'timestamp' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms' | 'timestamptz', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
  - HistoryQueryRESTItemDTO — History query item DTO for the REST API.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthRestItemSettings, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', required
      - `endpoint` string, required
      - `returnType` 'file' | 'body', required
      - `queryParams` SouthRestItemSettingsQueryParams[], required
        - `key` string, required
        - `value` string, required
        - `dateTimeInput` SouthRestItemSettingsQueryParamsDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string, nullable
      - `headers` SouthRestItemSettingsHeaders[], required
        - `key` string, required
        - `value` string, required
        - `dateTimeInput` SouthRestItemSettingsHeadersDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string, nullable
      - `body` SouthRestItemSettingsBody
        - `content` string, nullable, required
        - `dateTimeInput` SouthRestItemSettingsBodyDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string, nullable
      - `trackingInstant` SouthRestItemSettingsTrackingInstant
        - `trackInstant` boolean, required
        - `jsonPath` string
        - `dateTimeInput` SouthRestItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string
  - HistoryQueryS7ItemDTO — History query item DTO for Siemens S7.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthS7ItemSettings, required
      - `address` string, required
  - HistoryQuerySFTPItemDTO — History query item DTO for SFTP file transfer.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthSFTPItemSettings, required
      - `remoteFolder` string, required
      - `regex` string, required
      - `minAge` number, double, required
      - `preserveFiles` boolean, required
      - `ignoreModifiedDate` boolean
      - `maxFiles` number, double, required
      - `maxSize` number, double, required
      - `recursive` boolean, required
  - HistoryQuerySQLiteItemDTO — History query item DTO for SQLite.
    - `id` string, required — The unique identifier of the entity.
    - `createdBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `updatedBy` UserInfo, required — Represents the user who performed an action, with a computed display name.
      - `id` string, required — The unique identifier of the user.
      - `friendlyName` string, required — A human-readable display name for the user. "OIAnalytics" for the oianalytics system user, "Admin" for the admin login, or "Firstname Lastname (login)" for regular users.
    - `createdAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `updatedAt` string, required — Represents an instant in time as an ISO 8601 string.
    - `name` string, required
    - `enabled` boolean, required
    - `settings` SouthSQLiteItemSettings, required
      - `query` string, required
      - `trackingInstant` SouthSQLiteItemSettingsTrackingInstant, required
        - `trackInstant` boolean, required
        - `fieldName` string
        - `dateTimeInput` SouthSQLiteItemSettingsTrackingInstantDateTimeInput
          - `type` 'string' | 'iso-string' | 'unix-epoch' | 'unix-epoch-ms', required
          - `timezone` string — Represents a timezone as an IANA timezone string.
          - `format` string
          - `locale` string

## Changes

- **2026-09-23** `92023a2f20ae` — 10 breaking, 6 info
  - removed the required property `anyOf[#/components/schemas/HistoryQueryMSSQLItemDTO]/settings/dateTimeFields` from the response with the `200` status
  - removed the required property `anyOf[#/components/schemas/HistoryQueryMSSQLItemDTO]/settings/serialization` from the response with the `200` status
  - removed the required property `anyOf[#/components/schemas/HistoryQueryMySQLItemDTO]/settings/dateTimeFields` from the response with the `200` status
  - removed the required property `anyOf[#/components/schemas/HistoryQueryMySQLItemDTO]/settings/serialization` from the response with the `200` status
  - …12 more
- **2026-09-21** `fbefadfe3be3` — 5 breaking, 11 info
  - removed the required property `anyOf[#/components/schemas/HistoryQueryMSSQLItemDTO]/settings/trackingInstant` from the response with the `200` status
  - removed the required property `anyOf[#/components/schemas/HistoryQueryMySQLItemDTO]/settings/trackingInstant` from the response with the `200` status
  - removed the required property `anyOf[#/components/schemas/HistoryQueryOracleItemDTO]/settings/trackingInstant` from the response with the `200` status
  - removed the required property `anyOf[#/components/schemas/HistoryQueryPostgreSQLItemDTO]/settings/trackingInstant` from the response with the `200` status
  - …12 more
- …earlier changes not shown

[Full history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/history/:historyId/items/:itemId/get.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optimistiksas/apis/oibus-api/revisions/011be71f42e5?raw)