Hours Account

List of valid attributes:

Attribute	Description	Specifics
date	Date that the entry refers to - calculations are done in the account’s business timezone (Europe/Berlin by default)	ISO-8601 formatted date (string), always set
target_seconds	The time the user is supposed to work on the given date based on the user’s working time model(s)	duration in seconds (integer), always set
actual_seconds	The time the user has worked on the given date based on the user’s confirmed time trackings	duration in seconds (integer), always set
absent_seconds	Not supported yet, always reports 0	duration in seconds (integer), always set
balance_seconds	The change to the user’s total time balance on the given date	duration in seconds (integer), always set

List

Example response:

{
  "data": [
    {
      "id": "2026-01-01",
      "type": "hours_account",
      "attributes": {
        "date": "2026-01-01",
        "target_seconds": 28800,
        "actual_seconds": 28080,
        "absent_seconds": 0,
        "balance_seconds": -720
      }
    },
    ...
    {
      "id": "2026-01-31",
      "type": "hours_account",
      "attributes": {
        "date": "2026-01-31",
        "target_seconds": 28800,
        "actual_seconds": 28860,
        "absent_seconds": 0,
        "balance_seconds": 60
      }
    }
  ]
}

This endpoint returns the hours account entries for a user in a given time frame.

Note

The endpoint doesn’t necessarily return all entries in the specified date range at once because data still goes through our pagination mechanism. To get all entries from the desired date range, make sure to request all pages or increase the page size to something that guarantees that all dates in the range fit on one page (e.g. 31 if you’re getting data for one month).

HTTP Request

GET /api/v1/users/:user_id/hours_account_entries

Parameter	Description
user_id	ID of the user for whom to list hours account entries.

The following query parameters are mandatory:

Parameter	Description
start_date	The start date of the date range for which to list hours account entries.
end_date	The end date (inclusive) of the date range for which to list hours account entries.

Example: GET /api/v1/users/user-1/hours_account_entries?start_date=2026-01-01&end_date=2026-01-31