FAfactorialhr
Attendance > WorkedTime

Reads all Worked times

Changed on

Reads all Worked times

get/api/2026-10-01/resources/attendance/worked_times

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/attendance/worked_times
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: time_tracking
    • or API key in header x-api-key

Query parameters

ids[]string[]

Composite worked time id combining the employee_id and date, formatted as <employee_id>_<YYYY-MM-DD>.

[
  "1_2024-07-01"
]
start_onstring

Start of the date range to fetch worked times for (inclusive). Required together with end_on.

Example:2024-07-01
end_onstring

End of the date range to fetch worked times for (inclusive). Required together with start_on.

Example:2024-07-07
employee_ids[]string[]

Employee IDs to filter the date-range query by. When omitted, all attendable employees are returned.

[
  "1"
]
include_time_range_categoryboolean required

Whether to include the time range category on each worked time block.

include_non_attendable_employeesboolean required

Whether to include employees excluded from attendance (attendable=false) in the result. Forced to true when filtering by a single employee, so their historical worked time is returned even if they are no longer attendable.

Response

OK

Example response

{
  "data": [
    {
      "id": "1_2024-07-01"
    }
  ]
}

Changes