Aircon · JSON Structure

Aircon Sensor Reading Structure

A sensor measurement from a climate or environmental sensor associated with an HVAC system.

Type: object Properties: 7 Required: 4

Air ConditioningHVACClimate ControlIoTSmart HomeThermostatBuilding AutomationEnergy Management

SensorReading is a JSON Structure definition published by Aircon, describing 7 properties, of which 4 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

sensor_id sensor_type value unit location in_use timestamp

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/aircon/refs/heads/main/json-structure/aircon-sensor-reading-structure.json",
  "name": "SensorReading",
  "description": "A sensor measurement from a climate or environmental sensor associated with an HVAC system.",
  "type": "object",
  "properties": {
    "sensor_id": {
      "type": "string",
      "description": "Unique identifier for the sensor.",
      "example": "sensor-bedroom-01"
    },
    "sensor_type": {
      "type": "string",
      "enum": [
        "temperature",
        "humidity",
        "occupancy",
        "co2",
        "air_quality",
        "pressure"
      ],
      "description": "Type of sensor measurement.",
      "example": "temperature"
    },
    "value": {
      "type": "double",
      "description": "Measured sensor value.",
      "example": 71.2
    },
    "unit": {
      "type": "string",
      "description": "Unit of the measurement.",
      "example": "fahrenheit"
    },
    "location": {
      "type": "string",
      "description": "Physical location of the sensor.",
      "example": "Bedroom"
    },
    "in_use": {
      "type": "boolean",
      "description": "Whether the sensor is actively used for thermostat control.",
      "example": true
    },
    "timestamp": {
      "type": "datetime",
      "description": "Timestamp of the reading.",
      "example": "2026-04-19T10:30:00Z"
    }
  },
  "required": [
    "sensor_id",
    "sensor_type",
    "value",
    "timestamp"
  ]
}