---
title: "Get time entries for a user on a workspace"
method: GET
path: "/v1/workspaces/{workspaceId}/user/{userId}/time-entries"
tags: ["Time entry"]
---

# Get time entries for a user on a workspace

`GET /v1/workspaces/{workspaceId}/user/{userId}/time-entries`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.
- `userId` string, required — Represents a user identifier across the system.

## Query parameters

- `description` string — Represents a term for searching time entries by description.
- `start` string — Represents a start date in the yyyy-MM-ddThh:mm:ssZ format.
- `end` string — Represents an end date in the yyyy-MM-ddThh:mm:ssZ format.
- `project` string — If provided, you'll get a filtered list of time entries that matches the provided string in their project id.
- `task` string — If provided, you'll get a filtered list of time entries that matches the provided string in their task id.
- `tags` string[] — If provided, you'll get a filtered list of time entries that matches the provided string(s) in their tag id(s).
- `project-required` boolean — Flag to set whether to only get time entries which have a project.
- `task-required` boolean — Flag to set whether to only get time entries which have tasks.
- `hydrated` boolean — Flag to set whether to include additional information on time entries or not.
- `page` integer — Page number.
- `page-size` integer — Page size.
- `in-progress` string
- `get-week-before` string — Valid yyyy-MM-ddThh:mm:ssZ format date. If provided, filters results within the week before the datetime provided and only those entries with assigned project or task.

## Response `200`

OK

- TimeEntryWithRatesDtoV1[]
  - `billable` boolean — Indicates whether a time entry is billable.
  - `costRate` RateDtoV1 — Represents cost rate object.
    - `amount` integer — Represents an amount as integer.
    - `currency` string — Represents a currency.
  - `customFieldValues` CustomFieldValueDtoV1[] — Represents a list of custom field value objects.
    - `customFieldId` string — Represents custom field identifier across the system.
    - `name` string — Represents custom field name.
    - `timeEntryId` string — Represents time entry identifier across the system.
    - `type` string — Represents a custom field value source type.
    - `value` object — Represents custom field value.
  - `description` string — Represents time entry description.
  - `hourlyRate` RateDtoV1 — Represents cost rate object.
    - `amount` integer — Represents an amount as integer.
    - `currency` string — Represents a currency.
  - `id` string — Represents time entry identifier across the system.
  - `isLocked` boolean — Represents whether time entry is locked for modification.
  - `kioskId` string — Represents kiosk identifier across the system.
  - `projectId` string — Represents project identifier across the system.
  - `tagIds` string[] — Represents a list of tag identifiers across the system.
  - `taskId` string — Represents task identifier across the system.
  - `timeInterval` TimeIntervalDtoV1 — Represents a time interval object.
    - `duration` string — Represents a time duration.
    - `end` string, date-time — Represents an end date in yyyy-MM-ddThh:mm:ssZ format.
    - `start` string, date-time — Represents a start date in yyyy-MM-ddThh:mm:ssZ format.
  - `type` 'REGULAR' | 'BREAK' | 'HOLIDAY' | 'TIME_OFF' — Represents a time entry type enum.
  - `userId` string — Represents user identifier across the system.
  - `workspaceId` string — Represents workspace identifier across the system.

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)