---
title: "Clock-in and clock-out"
method: GET
path: "/time-entries"
tags: ["attendance"]
---

# Clock-in and clock-out

`GET /time-entries`

## Request

- Base URL: `https://api.taktovka.com/v1`
- URL: `https://api.taktovka.com/v1/time-entries`
- Auth: HTTP bearer

Attendance records whose clock-in falls on a day of the range on the location's clock, exactly as recorded; `corrected` marks a row a manager entered or changed. `from` and `to` are local dates, both included, at most 93 days apart; `next_cursor` is always null.

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `employee` string, uuid
- `location` string, uuid

## Response `200`

OK

- object
  - `data` TimeEntry[], required
    - `id` string, uuid, required
    - `employee_id` string, uuid, required
    - `location_id` string, uuid, required
    - `shift_id` string, uuid, nullable, required: The planned shift the entry belongs to; null for unplanned work
    - `clock_in` string, date-time, required: ISO 8601 instant with the location's offset at that moment
    - `clock_out` string, date-time, nullable, required: ISO 8601 instant with the location's offset at that moment
    - `source` 'qr' | 'manual' | 'pos', required
    - `offline_in` boolean, required: The clock-in was read on a phone without signal and delivered later
    - `offline_out` boolean, required
    - `corrected` boolean, required: A manager entered or corrected the row
    - `note` string, nullable, required: Reason of the manual entry or the last correction
  - `next_cursor` string, nullable, required

## Other responses

- `400`: validation_failed, range_too_long or key_in_query
- `401`: unauthenticated, invalid_key, key_revoked or key_expired
- `403`: insufficient_scope (with required_scope)
- `429`: rate_limited (with retry_after and a Retry-After header)

---

[API](https://skmtc.dev/taktovka/apis/taktovka-api.md) · [All operations](https://skmtc.dev/taktovka/apis/taktovka-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taktovka/apis/taktovka-api/revisions/612199b365e1?raw)