{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tibber/main/json-schema/tibber-device-history-schema.json",
  "title": "Tibber Data API Device History Page",
  "description": "Paginated, immutable historical time series for a Tibber-linked device.",
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "effectiveStart": { "type": "string", "format": "date-time" },
        "effectiveEnd": { "type": "string", "format": "date-time" },
        "resolution": { "type": "string", "enum": ["quarterHour", "hour", "day", "month"] }
      }
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": { "type": "string", "format": "date-time" },
          "to": { "type": "string", "format": "date-time" },
          "metrics": {
            "type": "object",
            "additionalProperties": { "type": "number" },
            "description": "Numeric measurements; keys vary by device category (e.g. energyConsumed, soc, indoorTemperature, powerProduced)."
          }
        }
      }
    },
    "next": { "type": "string", "format": "uri" },
    "prev": { "type": "string", "format": "uri" }
  }
}