---
title: "Return a list of attendances."
method: GET
path: "/attendances"
tags: ["Attendance"]
---

# Return a list of attendances.

`GET /attendances`

This endpoint returns an array of objects with all the existing attendance entries within Kenjo for a maximum of 31 days, defined by the required params **from** and **to**. Every object contains an attendance entry.

## Query parameters

- `from` string, required
- `to` string, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- object[]
  - `_id` string — The Kenjo _id of the returned attendance entry.
  - `userId` string — The Kenjo _id of the employee assigned to the attendance entry.
  - `email` string — The Kenjo email of the employee assigned to the attendance entry.
  - `externalId` string — The external id of the employee assigned to the attendance entry.
  - `startTime` string — The start date time of the attendance entry.
  - `endTime` string — The end date time of the attendance entry.
  - `breaks` object[] — Array that contains the breaks in detail.
    - `start` string — The start time of the break.
    - `end` string — The end time of the break.
  - `breakTime` string — The break time of the attendance entry. If there is no 'breaktime' this field will not be in the response. This value is the sum of the total time of breaks.
  - `paidBreakTime` number — Number of minutes of paid break time. If there is no 'paidBreakTime' this field will not be in the response. This value is the sum of the total time of paid breaks, which can be configured in the settings of the attendance policy.
  - `attendanceCategoryId` string — The Kenjo _id of the attendance category.
  - `attendanceSubCategoryId` string — The Kenjo _id of the attendance sub category.
  - `comment` string — Optional text to describe an attendance record (pair of startTime and endTime). The maximum number of characters is 150.

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