---
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`

## Request

- Base URL: `https://sandbox-api.kenjo.io/api/v1`
- URL: `https://sandbox-api.kenjo.io/api/v1/work-schedules/contracted-weekly-minutes`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/kenjo/apis/kenjo-api/docs/work-schedules/contracted-weekly-minutes/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/kenjo/apis/kenjo-api.md) - [All operations](https://skmtc.dev/kenjo/apis/kenjo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kenjo/apis/kenjo-api/revisions/58772b78268e?raw)