GetUsers

[POST] .../v1/workscheduleassignment/getusers

Returns work schedule assignments to users. Use this method to list schedule assignments applied directly to users before changing employee WorkTime planning. The response returns paginated WorkUserSchedule rows with user_id, schedule_id, date range, active flag, created_user_id, last_update, next_offset and total; the request body is required and supports user_ids, schedule_ids, active, date, limit and offset fields plus the OpenAPI filter metadata for the same query surface. The caller must have work schedule assignment select permission 693 and date is interpreted in account date format to select assignments active on that date. Missing body, denied permission, invalid date filters and database errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.
limit Int32 Optional Maximum number of returned items.
offset Int32 Optional Result set offset.

Filterable Fields

Field Type Description
active bool Assignment activity filter.
date string Filter date in YYYY-MM-DD format.
schedule_id int Schedule ID array.
user_id int User IDs.

Request Example

{
  "filters": [
    {
      "Field": "user_id",
      "Operator": "In",
      "Value": "10"
    },
    {
      "Field": "schedule_id",
      "Operator": "In",
      "Value": "14"
    },
    {
      "Field": "active",
      "Operator": "Equal",
      "Value": "true"
    },
    {
      "Field": "date",
      "Operator": "Equal",
      "Value": "2026-03-01"
    }
  ],
  "limit": 50,
  "offset": 0
}

Response Parameters

Name Type Description
next_offset Int32 Offset for the next data page.
ok Boolean Indicates whether the request completed successfully.
result Array of WorkUserSchedule Result array.
total Int64 Total number of result items.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 41,
      "user_id": 10,
      "schedule_id": 14,
      "date_from": "2026-03-01",
      "date_to": null,
      "active": true,
      "created_user_id": 5,
      "last_update": 1772527200
    }
  ],
  "next_offset": 0,
  "total": 1
}