{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/wakatime/json-schema/wakatime-stats-schema.json",
  "title": "Stats",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/wakatime-stats-api-openapi.yml#/components/schemas/Stats",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "user_id": {
      "type": "string"
    },
    "username": {
      "type": [
        "string",
        "null"
      ]
    },
    "range": {
      "type": "string"
    },
    "start": {
      "type": "string",
      "format": "date-time"
    },
    "end": {
      "type": "string",
      "format": "date-time"
    },
    "days_including_holidays": {
      "type": "integer"
    },
    "days_minus_holidays": {
      "type": "integer"
    },
    "holidays": {
      "type": "integer"
    },
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "updating",
        "pending"
      ]
    },
    "is_up_to_date": {
      "type": "boolean"
    },
    "percent_calculated": {
      "type": "integer"
    },
    "timeout": {
      "type": "integer"
    },
    "writes_only": {
      "type": "boolean"
    },
    "timezone": {
      "type": "string"
    },
    "total_seconds": {
      "type": "number",
      "format": "float"
    },
    "total_seconds_including_other_language": {
      "type": "number",
      "format": "float"
    },
    "daily_average": {
      "type": "number",
      "format": "float"
    },
    "daily_average_including_other_language": {
      "type": "number",
      "format": "float"
    },
    "human_readable_total": {
      "type": "string"
    },
    "human_readable_daily_average": {
      "type": "string"
    },
    "best_day": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "format": "date"
        },
        "total_seconds": {
          "type": "number",
          "format": "float"
        },
        "text": {
          "type": "string"
        }
      }
    },
    "languages": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "projects": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "editors": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "operating_systems": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "machines": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "dependencies": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SummaryBreakdown"
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "modified_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "$defs": {
    "SummaryBreakdown": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "total_seconds": {
          "type": "number",
          "format": "float"
        },
        "percent": {
          "type": "number",
          "format": "float"
        },
        "digital": {
          "type": "string"
        },
        "decimal": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "hours": {
          "type": "integer"
        },
        "minutes": {
          "type": "integer"
        },
        "seconds": {
          "type": [
            "integer",
            "null"
          ]
        },
        "machine_name_id": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}