---
title: "Get time entries for a specific period"
method: GET
path: "/v1/public/time-entries"
tags: ["Public", "Timesheets"]
---

# Get time entries for a specific period

`GET /v1/public/time-entries`

## Request

- Base URL: `https://api.evolia.com`
- URL: `https://api.evolia.com/v1/public/time-entries`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evolia/apis/public-evolia/docs/v1/public/time-entries/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `fromDate` number, required
- `toDate` number, required
- `skillNames` string[]
- `teamNames` string[]
- `locationNames` string[]
- `forMemberIds` string[]
- `lockedOnly` boolean
- `validatedOnly` boolean
- `withCancelled` boolean

## Response `200`

- PublicTimeEntry
  - `uid` string, required: Unique time entry id. Same as the shift (event)
  - `externalId` string: Time entry externalId. Same as the shift (event).This externalId is provided when using the create or update event API.
  - `startsAt` string, required: Event Start date. In ISO-8601 format.
  - `endsAt` string, required: Event End date. In ISO-8601 format.
  - `firstName` string: When assigned, contains the member (employee) first name
  - `lastName` string: When assigned, contains the member (employee) first name
  - `memberId` string: When assigned, contains the member (employee) UID
  - `memberCode` string: When assigned, contains the member (employee) code
  - `memberEmail` string: When assigned, contains the member (employee) email
  - `hourlyWage` number: When assigned, contains the member hourly wage specific to the position of the entry
  - `positionId` string, required: The entry position UID (skill)
  - `position` string, required: The entry position name (skill)
  - `positionCode` string, required: The entry position code (skill)
  - `locationId` string: The entry location UID
  - `location` string: The entry location name
  - `locationCode` string: The entry location code
  - `subLocation` string: The entry sub-location code
  - `subLocationId` string: The entry sub-location UID
  - `subLocationCode` string: The entry sub-location code
  - `teamId` string, required: The entry team UID
  - `team` string, required: The entry team name
  - `teamCode` string, required: The entry team code
  - `isCancelled` boolean: If true this entry is cancelled
  - `isDraft` boolean: If true this event is draft
  - `note` string: The entry public note
  - `employeeNote` string: The entry employee note
  - `internalNote` string: The entry internal note. Only to visible to managers, supervisors and admin.
  - `clockedIn` string: Adjusted clock in time from company rules. This value is use to calculate the total worked hours. In ISO-8601 format.
  - `clockedInOriginal` string: The actual time when employee clocked in. In ISO-8601 format.
  - `clockedInNote` string: The note an employee may has left when clocking in.
  - `clockedInZone` boolean, required: If true, the employee has clocked in within the designated area of the work location.
  - `clockedInStatus` string, required: A text designating the status of the "in" clocking.
  - `clockedOut` string: Adjusted clock out time from company rules. This value is use to calculate the total worked hours. In ISO-8601 format.
  - `clockedOutOriginal` string: The actual time when employee clocked out. In ISO-8601 format.
  - `clockedOutNote` string: The note an employee may has left when clocking out.
  - `clockedOutZone` boolean, required: If true, the employee has clocked out within the designated area of the work location.
  - `clockedOutStatus` string, required: A text designating the status of the "out" clocking.
  - `clockingMgrNote` string: A note left by managers on the clocking of time entry.Not to be confused the event note.
  - `unpaidBreaks` number, required: Total unpaid breaks duration in hours and decimal. Ex: a 15 minutes is 0.25
  - `paidBreaks` number, required: Total paid breaks duration in hours and decimal. Ex: a 15 minutes is 0.25
  - `paidAmount` number: Paid amount
  - `workingHours` number, required: Worked hours with decimal. Ex 8h30 is 8.5
  - `plannedHours` number, required: Planned hours with decimal. Ex 8h30 is 8.5. Based on start time and end time, minus unpaid breaks, plus paidPreparationTimeInM
  - `paidPreparationTimeInM` number, required: The paid preparation time in minutes.
  - `lockedAt` string: Clocking update date and time. In ISO-8601 format.
  - `validatedAt` string: Clocking validation date and time. In ISO-8601 format.

---

[API](https://skmtc.dev/evolia/apis/public-evolia.md) - [All operations](https://skmtc.dev/evolia/apis/public-evolia/llms.txt) - [OpenAPI document](https://skmtc.dev/evolia/apis/public-evolia/revisions/e42abb18d4b6?raw)