---
title: "List UserDates."
method: GET
path: "/api/v3/userdates"
tags: ["UserDates"]
---

# List UserDates.

`GET /api/v3/userdates`

Retrieve a list of UserDates.

### Performance
In order to keep satisfactory response times and performance, please filter the request on a limited set of OwnerId[] and reduce the period  `date=between,{start},{end}`.

As a rule of thumb, do not request for more than ~10 owners over a whole month.

### Format
The `date` query parameter should match the form `?date=between,{start},{includedEnd}`.

## Query parameters

- `ownerId` integer[], required
- `date` string, required
- `fields` string[]

## Response `200`

OK

- object
  - `data` object
    - `items` UserDate[]
      - `source` 1 | 2 | 3 | 5 | 6 — - 1: WorkCycle - 2: Public Holidays - 3: WorkCycle Exception - 5: Leave (from Lucca Absences) - 6: Entry (from Lucca Timesheet)
      - `dtt` string, time — Theoretical working time. The work duration the User should comply with on this day. It is the result of the workcycle, minus the potential public holidays, delta potential workcycle exception overrides.
      - `drt` string, time — Actual working time. The actual time the User spent working on this day. Results from the time-entries entered in Lucca Timesheet. If no time-entry has been entered, then defaults to the DTT value.
      - `draj` string, time — Leave duration.
      - `isHoliday` boolean — Is this day a holiday in the User's holidays calendar?
      - `isWeeklyRest` boolean — Is this the weekly rest day (most often, Sundays) in the User's workcycle?
      - `items` UserDateItem[] — All events for this day and User.
        - `type` 'ptt' | 'prt' | 'praj' — Type of event: - `ptt`: Theoretical working hours, eg "What the User should be working". - `prt`: Actual working hours, eg "What the User actually did". If nothing was entered in Lucca Timesheet nor Lucca Absences, then ptt are duplicated as prt. - `praj`: Leave of absences.
        - `startsAt` string, date-time — Start of the event.
        - `duration` string, time — Duration of the event.
        - `timeline` 'WorkCycle' | 'PublicHoliday' | 'Exception' | 'Leave' | 'Entry' — The source from which this event was pushed.
      - `am` IUserDate
        - `source` 1 | 2 | 3 | 5 | 6 — - 1: WorkCycle - 2: Public Holidays - 3: WorkCycle Exception - 5: Leave (from Lucca Absences) - 6: Entry (from Lucca Timesheet)
        - `dtt` string, time — Theoretical working time. The work duration the User should comply with on this day. It is the result of the workcycle, minus the potential public holidays, delta potential workcycle exception overrides.
        - `drt` string, time — Actual working time. The actual time the User spent working on this day. Results from the time-entries entered in Lucca Timesheet. If no time-entry has been entered, then defaults to the DTT value.
        - `draj` string, time — Leave duration.
        - `isHoliday` boolean — Is this day a holiday in the User's holidays calendar?
        - `isWeeklyRest` boolean — Is this the weekly rest day (most often, Sundays) in the User's workcycle?
        - `items` UserDateItem[] — All events for this day and User.
          - `type` 'ptt' | 'prt' | 'praj' — Type of event: - `ptt`: Theoretical working hours, eg "What the User should be working". - `prt`: Actual working hours, eg "What the User actually did". If nothing was entered in Lucca Timesheet nor Lucca Absences, then ptt are duplicated as prt. - `praj`: Leave of absences.
          - `startsAt` string, date-time — Start of the event.
          - `duration` string, time — Duration of the event.
          - `timeline` 'WorkCycle' | 'PublicHoliday' | 'Exception' | 'Leave' | 'Entry' — The source from which this event was pushed.
      - `pm` IUserDate
        - `source` 1 | 2 | 3 | 5 | 6 — - 1: WorkCycle - 2: Public Holidays - 3: WorkCycle Exception - 5: Leave (from Lucca Absences) - 6: Entry (from Lucca Timesheet)
        - `dtt` string, time — Theoretical working time. The work duration the User should comply with on this day. It is the result of the workcycle, minus the potential public holidays, delta potential workcycle exception overrides.
        - `drt` string, time — Actual working time. The actual time the User spent working on this day. Results from the time-entries entered in Lucca Timesheet. If no time-entry has been entered, then defaults to the DTT value.
        - `draj` string, time — Leave duration.
        - `isHoliday` boolean — Is this day a holiday in the User's holidays calendar?
        - `isWeeklyRest` boolean — Is this the weekly rest day (most often, Sundays) in the User's workcycle?
        - `items` UserDateItem[] — All events for this day and User.
          - `type` 'ptt' | 'prt' | 'praj' — Type of event: - `ptt`: Theoretical working hours, eg "What the User should be working". - `prt`: Actual working hours, eg "What the User actually did". If nothing was entered in Lucca Timesheet nor Lucca Absences, then ptt are duplicated as prt. - `praj`: Leave of absences.
          - `startsAt` string, date-time — Start of the event.
          - `duration` string, time — Duration of the event.
          - `timeline` 'WorkCycle' | 'PublicHoliday' | 'Exception' | 'Leave' | 'Entry' — The source from which this event was pushed.

## Other responses

- `400` — Problem
- `401` — Problem
- `404` — Problem
- `500` — Problem

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)