{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/airthings/json-schema/airthings-get-location-samples-response-enriched-schema.json",
  "title": "GetLocationSamplesResponse-enriched",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/airthings-locations-api-openapi.yml#/components/schemas/GetLocationSamplesResponse-enriched",
  "type": "object",
  "properties": {
    "devices": {
      "items": {
        "$ref": "#/$defs/DeviceSampleResponse-enriched"
      },
      "description": "list of devices in the location",
      "type": "array"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "devices",
    "id",
    "name"
  ],
  "$defs": {
    "DeviceSampleResponse-enriched": {
      "type": "object",
      "properties": {
        "data": {
          "$ref": "#/$defs/LatestSampleData-enriched",
          "description": "latest sample data for the device"
        },
        "id": {
          "type": "string",
          "maxLength": 10,
          "minLength": 10
        },
        "segment": {
          "$ref": "#/$defs/SegmentSimpleResponse-enriched",
          "description": "segment of the device with samples"
        }
      },
      "required": [
        "data",
        "id",
        "segment"
      ]
    },
    "LatestSampleData-enriched": {
      "type": "object",
      "properties": {
        "airExchangeRate": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ],
          "description": "air changes per hour (ACH)"
        },
        "airflow": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ],
          "description": "cubic meters per hour (m³/h) by default and gets converted to cubic feet per minute (CFM) if the user has set the unit preference to imperial"
        },
        "battery": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ]
        },
        "co2": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "controlSignal": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "hourlyRadon": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "humidity": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "light": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ]
        },
        "lux": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "float"
            }
          ]
        },
        "mold": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "occupants": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ]
        },
        "occupantsLower": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ]
        },
        "occupantsUpper": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ]
        },
        "pm1": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "pm10": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "pm25": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "pressure": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "radonShortTermAvg": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "relayDeviceType": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "string"
            }
          ]
        },
        "rssi": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ]
        },
        "sla": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "temp": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "time": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "int32"
            }
          ],
          "description": "timestamp of samples sent by the device"
        },
        "virusRisk": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        },
        "voc": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "number",
              "format": "double"
            }
          ]
        }
      },
      "required": []
    },
    "SegmentSimpleResponse-enriched": {
      "type": "object",
      "properties": {
        "active": {
          "type": "boolean"
        },
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string"
        },
        "spaceId": {
          "oneOf": [
            {
              "type": "null"
            },
            {
              "type": "string",
              "format": "uuid",
              "description": "Space ID where the device segment is/was located. It is null for old ended non-space segments"
            }
          ]
        },
        "started": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "active",
        "id",
        "name",
        "started"
      ]
    }
  }
}