---
title: "Get time entries within a date range"
method: GET
path: "/v2/team/{team_Id}/time_entries"
tags: ["Time Tracking"]
---

# Get time entries within a date range

`GET /v2/team/{team_Id}/time_entries`

View time entries filtered by start and end date. \
 \
By default, this endpoint returns time entries from the last 30 days created by the authenticated user. \
 \
To retrieve time entries for other users, you must include the `assignee` query parameter. \
 \
Only one of the following location filters can be included at a time: `space_id`, `folder_id`, `list_id`, or `task_id`. \
 \
***Note:** A time entry that has a negative duration means that timer is currently running for that user.*

## Path parameters

- `team_Id` number, required

## Query parameters

- `start_date` number
- `end_date` number
- `assignee` number
- `include_task_tags` boolean
- `include_location_names` boolean
- `include_approval_history` boolean
- `include_approval_details` boolean
- `space_id` number
- `folder_id` number
- `list_id` number
- `task_id` string
- `custom_task_ids` boolean
- `team_id` number
- `is_billable` boolean

## Headers

- `Content-Type` 'application/json', required

## Response `200`

If your time entry is associated with a task that uses custom task ids you can expect a `custom_id`` field in the body of the response. The task field will only be included if there is a task associated with a time entry.

- object
  - `data` object[], required
    - `id` string, required
    - `task` object, required
      - `id` string, required
      - `custom_id` string, required
      - `name` string, required
      - `status` Status, required — unresolved $ref
      - `custom_type` string, nullable, required
    - `wid` string, required
    - `user` User, required — unresolved $ref
    - `billable` boolean, required
    - `start` string, required
    - `end` string, required
    - `duration` string, required
    - `description` string, required
    - `tags` string[], required
    - `source` string, required
    - `at` string, required
    - `approval_id` string — ID of the associated approval
    - `approval` Approval — unresolved $ref
    - `task_location` TaskLocation, required — unresolved $ref
    - `task_tags` Items[], required — unresolved $ref
    - `task_url` string, required

---

[API](https://skmtc.net/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.net/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)