{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/workday-tracking-system/refs/heads/main/json-structure/time-tracking-time-blocks-response-structure.json",
  "name": "TimeBlocksResponse",
  "description": "Paginated response containing time blocks",
  "type": "object",
  "properties": {
    "total": {
      "type": "int32",
      "description": "Total number of time blocks matching the query"
    },
    "offset": {
      "type": "int32",
      "description": "Current pagination offset"
    },
    "limit": {
      "type": "int32",
      "description": "Maximum records returned per page"
    },
    "data": {
      "type": "array",
      "description": "Array of time blocks",
      "items": {
        "type": "object",
        "description": "A reported or calculated time block representing hours worked",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique Workday ID of the time block"
          },
          "workerId": {
            "type": "string",
            "description": "Workday ID of the worker"
          },
          "date": {
            "type": "date",
            "description": "Date of the time block"
          },
          "startTime": {
            "type": "time",
            "description": "Start time of the time block (HH:MM:SS)"
          },
          "endTime": {
            "type": "time",
            "description": "End time of the time block (HH:MM:SS)"
          },
          "hours": {
            "type": "float",
            "description": "Total hours in the time block"
          },
          "type": {
            "type": "string",
            "description": "Type of time block",
            "enum": [
              "Regular",
              "Overtime",
              "Holiday",
              "Leave"
            ]
          },
          "status": {
            "type": "string",
            "description": "Status of the time block",
            "enum": [
              "Reported",
              "Calculated",
              "Approved",
              "Rejected"
            ]
          },
          "projectId": {
            "type": "string",
            "description": "Associated project ID (optional)"
          },
          "taskId": {
            "type": "string",
            "description": "Associated task ID (optional)"
          },
          "comment": {
            "type": "string",
            "description": "Optional comment for the time block"
          },
          "createdAt": {
            "type": "datetime",
            "description": "Timestamp when the time block was created"
          },
          "modifiedAt": {
            "type": "datetime",
            "description": "Timestamp when the time block was last modified"
          }
        },
        "required": [
          "workerId",
          "date",
          "hours",
          "type"
        ]
      }
    }
  }
}