GET /api/time_entries/daily_stats
Get work time stats for a user with a daily breakdown

Get work time stats for a user with a daily breakdown for a given date range.

Stats will include:

  • date
  • actual (logged) work time, in minutes
  • billable time, in minutes
  • utilization rate, 0–100.0
  • mandatory working time, in minutes
  • absence time, in minutes
  • work time balance (ignoring balance correction), in minutes
  • imported balance correction, in minutes
  • is the date locked, boolean

Permissions. User's work time balance can be accessed by:

  • user themselves
  • user's approvers
  • company's managers and accountants

Examples

[
   {
    "date": "2025-03-25",
    "actual_worked_time": 720,
    "billable_time": 240,
    "utilization": 33.33,
    "mandatory_working_time": 480,
    "absence_time": 0,
    "is_locked": false,
    "work_time_balance": 240,
    "balance_correction": 0
  },
  {
    "date": "2025-03-26",
    "actual_worked_time": 0,
    "billable_time": 0,
    "utilization": null,
    "mandatory_working_time": 480,
    "absence_time": 0,
    "is_locked": true,
    "work_time_balance": -480,
    "balance_correction": 0
  }
]

Params

Param name Description
user_id
optional

User ID. Default: current user ID.

Validations:

  • Must be a Integer
start_date
optional

Date to start the balance calculations from. Default: date of the user’s first time entry. If start date has not been passed explicitly and user has no time entries, time balance will not be calculated.

Validations:

  • Must be a String
end_date
optional

Date to end the balance calculations with, inclusive. Default: yesterday.

Validations:

  • Must be a String
date_range
optional

Get stats within the specified date range.Either pass date_range or start/end dates. Date range format: "DD/MM/YYYY - DD/MM/YYYY" (e.g. 15/02/2025 - 28/02/2025).

Validations:

  • Must be a String