v1

latestOpenAPI 3.1.02026-07-24172151607.6 KB

Time Tracking

Get singular time entry

View a single time entry.

Note: A time entry that has a negative duration means that timer is currently running for that user.

get/v2/team/{team_id}/time_entries/{timer_id}

Path parameters

team_idnumber required

Example:123

Workspace ID

timer_idstring required

Example:1963465985517105840

The ID of a time entry.

This can be found using the Get Time Entries Within a Date Range endpoint.

Query parameters

include_task_tagsboolean

Include task tags in the response for time entries associated with tasks.

include_location_namesboolean

Include the names of the List, Folder, and Space along with list_id,folder_id, and space_id.

include_approval_historyboolean

Include the history of the approval for the time entry.

include_approval_detailsboolean

Include the details of the approval for the time entry.

Headers

Content-Type'application/json' required

Example:application/json

Response

Example response

{
  "data": [
    {
      "id": "timer_id",
      "wid": "workspace_id",
      "user": {
        "id": 1,
        "username": "first_name last_name",
        "email": "test@gmail.com",
        "color": "#08c7e0",
        "initials": "JK",
        "profilePicture": "https://attachments-public.clickup.com/profilePictures/1_HHk.jpg"
      },
      "billable": false,
      "start": "1592841559129",
      "end": "1592845899021",
      "duration": "4339892",
      "description": "",
      "tags": [],
      "source": "clickup",
      "at": "1592845899021",
      "approval_id": "2d539936-119a-4927-9770-179f0a72e2e5",
      "approval": {
        "$ref": "#/paths/~1v2~1team~1%7Bteam_Id%7D~1time_entries/get/responses/200/content/application~1json/schema/examples/0/data/0/approval"
      },
      "task_location": {
        "list_id": 1560300071,
        "folder_id": 468300080,
        "space_id": 22800253,
        "list_name": "List",
        "folder_name": "Folder",
        "space_name": "Space"
      },
      "task_tags": [
        {
          "name": "content-request",
          "tag_fg": "#800000",
          "tag_bg": "#2ecd6f",
          "creator": 301828
        },
        {
          "name": "marketing-okr",
          "tag_fg": "#800000",
          "tag_bg": "#7C4DFF",
          "creator": 301828
        }
      ],
      "task_url": "https://staging.clickup.com/t/rnmuwz7"
    }
  ]
}