---
title: "GET /v2/usersNonbusinessDays"
method: GET
path: "/v2/usersNonbusinessDays"
tags: ["UserNonbusinessDay"]
---

# GET /v2/usersNonbusinessDays

`GET /v2/usersNonbusinessDays`

## Query parameters

- `filter` object
  - `users_id` union
    - integer[]
    - integer
    - string, csv-string
- `items_per_page` integer
- `page` integer
- `year` integer

## Response `200`

Successful operation

- object
  - `paging` object, required
    - `items_per_page` integer, required
    - `current_page` integer, required
    - `count_pages` integer, required
    - `count_items` integer, required
  - `data` UsersNonbusinessDayV2[], required
    - `users_id` integer, required
    - `days` NonbusinessDayV2[], required — Nonbusiness days that apply for the user in the queried time span
      - `id` integer, required
      - `nonbusiness_group_id` integer, required
      - `type` 'SPECIAL' | 'DISTINCT_ONCE' | 'DISTINCT_RECURRING', required — Possible values: - `SPECIAL`: Special - `DISTINCT_ONCE`: DistinctOnce - `DISTINCT_RECURRING`: DistinctRecurring
      - `name` string, required
      - `half_day` boolean, required
      - `surcharge_special` boolean, required
      - `special_id` integer
      - `evaluated_date` string, date, required — Default: CurrentYear
      - `day` integer — only for types DISTINCT_ONCE and DISTINCT_RECURRING
      - `month` integer — only for types DISTINCT_ONCE and DISTINCT_RECURRING
      - `year` integer — only for type DISTINCT_ONCE

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/clockodo/apis/clockodo-api-documentation.md) · [All operations](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockodo/clockodo-api-documentation/revisions/38e281d50d6d/schema)