---
title: "Returns the contracted weekly minutes per employee for a given date."
method: GET
path: "/work-schedules/contracted-weekly-minutes"
tags: ["Work Schedule"]
---

# Returns the contracted weekly minutes per employee for a given date.

`GET /work-schedules/contracted-weekly-minutes`

Returns a paginated list of employees with their contracted weekly working minutes effective on the requested date. The value is read from `Work schedule` section of the employee profile (entry with the latest `effective date <= date`).
Limitations:
- The `limit` parameter accepts one of `25`, `50`, `100`.
- The `userId` CSV filter accepts at most 15 ids.

## Query parameters

- `date` string
- `companyId` string
- `officeId` string
- `departmentId` string
- `userId` string
- `offset` string
- `limit` '25' | '50' | '100'

## Headers

- `Authorization` string, required

## Response `200`

OK.

- object
  - `data` object[]
    - `userId` string — The Kenjo employee id.
    - `weeklyMinutes` number — Contracted weekly minutes effective on the requested date.
  - `metadata` object
    - `count` number — Number of employees returned in this page (after archive/API-profile filtering).
    - `offset` number — Page number.
    - `limit` number — Page size.
    - `total` number — Total number of employees matching the filters (before archive/API-profile filtering).

## Other responses

- `400` — BAD REQUEST. This is a wrong request in the client side due to invalid body or params.
- `401` — UNAUTHORIZED. The Authorization header is incorrect, not provided or the token expired.

---

[API](https://skmtc.net/kenjo/apis/kenjo-api.md) · [All operations](https://skmtc.net/kenjo/apis/kenjo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenjo/kenjo-api/revisions/58772b78268e/schema)