---
title: "List time entries"
method: GET
path: "/time-entries"
tags: ["Time entries"]
---

# List time entries

`GET /time-entries`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/time-entries`
- Auth: API key in header `X-Api-Key`

Returns the company's time entries (working hours and absences), latest start first. Filters combine with AND.

## Query parameters

- `page` integer
- `limit` integer
- `projectId` string, uuid
- `jobId` string, uuid
- `profileId` string, uuid
- `status` 'pending' | 'approved' | 'declined'
- `from` string, date-time
- `to` string, date-time

## Response `200`

A page of time entries

- object
  - `items` TimeEntry[], required
    - `id` string, uuid, required
    - `projectId` string, uuid, nullable
    - `jobId` string, uuid, nullable: The appointment (see `GET /jobs`) the time was booked on.
    - `profileId` string, uuid, required: The team member the time belongs to.
    - `startAt` string, date-time, required
    - `endAt` string, date-time, required
    - `startTime` string, date-time, required: Same as `startAt`. Use `startAt`; this name will be removed.
    - `endTime` string, date-time, required: Same as `endAt`. Use `endAt`; this name will be removed.
    - `breakTimeMinutes` integer, required
    - `durationMinutes` integer, required: Minutes from `startAt` to `endAt` less `breakTimeMinutes`, never negative.
    - `status` 'pending' | 'approved' | 'declined', required: Approval state.
    - `entryType` 'working_hours' | 'absent' | 'null', nullable
    - `absenceType` 'vacation' | 'sick_leave' | 'educational_leave' | 'overtime_compensation' | 'public_holiday' | 'vocational_school' | 'sick_child' | 'vacation_unpaid' | 'other' | 'null', nullable: Kind of absence when `entryType` is `absent`.
    - `halfDayPeriod` 'morning' | 'afternoon' | 'null', nullable: Set when the absence covers half a day.
    - `categoryId` string, uuid, nullable
    - `categoryName` string, nullable
    - `note` string, nullable
    - `declinedReason` string, nullable
    - `createdByProfileId` string, uuid, required
    - `updatedByProfileId` string, uuid, nullable
    - `companyId` string, uuid, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `metadata` ListMetadata, required: Paging block of the public API's list envelope.
    - `page` integer, required: Current page number (1-based)
    - `limit` integer, required: Number of items per page
    - `total` integer, required: Total number of matching items across all pages

## Other responses

- `400`: Invalid request — a malformed id, filter, pagination parameter or body. The body is a plain-text message naming the problem.

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)