---
title: "Get time entries by user permissions"
method: POST
path: "/v3/time-entries/list"
tags: ["[v3] Time Entry"]
---

# Get time entries by user permissions

`POST /v3/time-entries/list`

Get time entries by user access and permissions.

## Request body

- object
  - `startDate` string, date, required — Start date
  - `endDate` string, date, required — End date
  - `userIds` integer[] — Array of user ids
  - `taskIds` integer[] — Array of task ids
  - `tagIds` integer[] — Array of tag ids

## Response `200`

OK response

- object[] — Array of time entry objects
  - `id` integer, required — Entry id
  - `duration` integer, required — Duration in seconds
  - `locked` integer, required — Whether the time entry is locked
  - `invoice_id` integer, required — Invoice id
  - `last_modify` string, date-time, required — Last modify date
  - `date` string, date, required — Time entry date
  - `start_time` string, required — Start time
  - `end_time` string, required — End time
  - `billable` boolean, required — Is billable
  - `description` string, nullable — Time entry description
  - `addons_external_id` string, required — External ID of the related task
  - `hasEntryLocationHistory` boolean — Whether the time entry has location history
  - `user` object, nullable, required — Related user data
    - `id` integer — User id
    - `email` string — User email
    - `display_name` string — User display name
  - `task` object, nullable, required — Related task data
    - `id` number — Task id
    - `name` string — Task name
    - `color` string — Task color
    - `billable` boolean — Task is billable
  - `tags` object[], required — Related tags data
    - `id` integer — Tag id
    - `name` string — Tag name
    - `mandatory` integer — Whether the tag is mandatory
    - `tag_list` object
      - `id` integer — Tag list id
      - `name` string — Tag list name

## Other responses

- `403` — The authenticated OAuth2 access token or PAT does not contain any scope accepted by the endpoint.

---

[API](https://skmtc.net/timecamp/apis/timecamp-api.md) · [All operations](https://skmtc.net/timecamp/apis/timecamp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timecamp/timecamp-api/versions/c7e9d1f9cf61/schema)