---
title: "Returns expected time per user for a given date range (paginated)."
method: GET
path: "/attendances/expected-time"
tags: ["Attendance"]
---

# Returns expected time per user for a given date range (paginated).

`GET /attendances/expected-time`

Returns a paginated list of the **daily Net Expected Time** per user for the given date range. This value represents the contractual working hours after subtracting deductions from Public Holidays and approved Time Off (based on either the Shiftplan or the theoretical work schedule pattern).
Limitations:
- The date range (from and to) must not exceed 90 days.
- The limit parameter is capped at 100 users per page.

## Query parameters

- `from` string, required
- `to` string, required
- `companyId` string
- `officeId` string
- `departmentId` string
- `userId` string
- `offset` number
- `limit` number

## Headers

- `Authorization` string, required

## Response `200`

OK.

- object
  - `data` object[]
    - `userId` string — The Kenjo _id of the returned user.
    - `days` object[] — Array that contains the days with the expected time information per user in the provided date range.
      - `date` string — The date in format YYYY-MM-DD.
      - `expectedHours` number — The number of expected hours for a given day.
      - `expectedMinutes` number — The number of expected minutes for a given day.
    - `totalExpectedHours` number — Total expected hours for the user in the date range.
    - `expectedMinutes` number — Total expected minutes for the user in the date range.
  - `metadata` object
    - `count` number — Number of users returned (according to the pagination limit and offset).
    - `offset` number — Number of records skipped for pagination.
    - `limit` number — Page size used (capped at 100 for this endpoint).
    - `total` number — Total number of users matching the filters.

## 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)