{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/karbonhq/json-schema/karbonhq-get-single-time-sheet-schema.json",
  "title": "GetSingleTimeSheet",
  "description": "A single TimeSheet with TimeEntries",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/karbonhq-timesheets-and-time-entries-api-openapi.yml#/components/schemas/GetSingleTimeSheet",
  "type": "object",
  "required": [
    "TimesheetKey",
    "StartDate",
    "EndDate",
    "UserKey",
    "Status"
  ],
  "properties": {
    "TimesheetKey": {
      "type": "string",
      "description": "A Karbon-generated unique identifier for the Timesheet"
    },
    "StartDate": {
      "type": "string",
      "format": "date-time",
      "description": "The start date for the TimeSheet"
    },
    "EndDate": {
      "type": "string",
      "format": "date-time",
      "description": "The end date for the TimeSheet"
    },
    "UserKey": {
      "type": "string",
      "description": "A Karbon-generated key used to identify the user, this Timesheet belongs to"
    },
    "Status": {
      "type": "string",
      "enum": [
        "Approved",
        "Declined",
        "Draft",
        "Submitted"
      ],
      "description": "The approval status of the Timesheet"
    },
    "WorkItemKeys": {
      "type": "array",
      "description": "An array of WorkItem keys",
      "items": {
        "type": "string"
      }
    },
    "TimeEntries": {
      "type": "array",
      "description": "An array of Time entries",
      "items": {
        "type": "object",
        "properties": {
          "TimeEntryKey": {
            "type": "string",
            "description": "A Karbon-generated key used to identify the Time Entry"
          },
          "EntityKey": {
            "type": "string",
            "description": "A Karbon-generated key used to identify the entity this Time Entry is related to"
          },
          "WorkItemKey": {
            "type": "string",
            "description": "A Karbon-generated key used to identify the Work Item this Time Entry is related to"
          },
          "ClientKey": {
            "type": "string",
            "description": "A Karbon-generated key used to identify the Client this Time Entry is related to"
          },
          "ClientType": {
            "type": "string",
            "description": "The type of Client"
          },
          "RoleName": {
            "type": "string",
            "description": "The role of the user for whom the Time Entry was created"
          },
          "TaskTypeName": {
            "type": "string",
            "description": "The type of task performed by the user"
          },
          "Minutes": {
            "type": "integer",
            "description": "The total time (in minutes) spent on the task"
          },
          "HourlyRate": {
            "type": "number",
            "format": "decimal",
            "description": "The hourly rate of the user who worked on the task"
          },
          "Descriptions": {
            "type": "array",
            "description": "Free-form text that has more information about the Time Entry",
            "items": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "BilledStatus": {
            "type": "string",
            "description": "An indicator that represents whether the time entry has been or is in the process of being billed",
            "enum": [
              "Unbilled",
              "Draft",
              "InterimBilled",
              "Billed"
            ]
          }
        }
      }
    }
  }
}