FAfactorialhr
Attendance > OpenShift

Reads all Open shifts

Changed on

Returns the currently open shifts. If employee_ids is provided, results are filtered to those employees. If employee_ids is omitted, callers holding the SeeAttendancePeriods permission (e.g. admin API keys) receive every open shift in the company; other callers receive only their own open shift.

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/attendance/open_shifts
  • 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

employee_ids[]string[]

Optional. Employee ids to filter the open shifts by. When omitted, callers holding the SeeAttendancePeriods permission receive all open shifts in the company; other callers receive only their own open shift.

[
  "1",
  "2",
  "3"
]

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "employee_id": "1",
      "date": "2024-06-06",
      "reference_date": "2024-06-06",
      "clock_in": "2000-01-01T02:35:25.000Z",
      "status": "opened",
      "workable": true,
      "location_type": "work_from_home",
      "workplace_id": "1",
      "time_settings_break_configuration_id": "1"
    }
  ]
}

Changes