---
title: "Get a time entry"
method: GET
path: "/1.0/time-entries/{timeEntryId}"
tags: ["Time Tracking"]
---

# Get a time entry

`GET /1.0/time-entries/{timeEntryId}`

This endpoint can be used to get a time entry using its ID. This API returns the time entry object that matches the ID. The `includeFields` param can be used to customise the response.

## Path parameters

- `timeEntryId` integer, required

## Query parameters

- `includeFields` string[]
- `includeAllFields` boolean

## Response `200`

The requested action was successfully executed.

- TimeEntryPublicAPIResponseEntity
  - `timeEntryId` integer — The unique, system-generated identifier, which can be used to identify the time entry globally.
  - `date` string — Date of the time entry in format YYYY-MM-DD
  - `minutes` integer — Duration of the time entry in minutes
  - `activityName` string — Name of the adhoc activity being performed
  - `project` TimeEntryProjectPublicAPIResponseEntity — Project associated with the time entry
    - `projectName` string — The name of the project.
    - `projectId` integer — The project’s unique, system-generated identifier, which can be used to identify the project globally.
  - `task` TimeEntryTaskPublicAPI — Task associated with the time entry
    - `taskName` string — The name of the task.
    - `taskId` integer — The task’s unique, system-generated identifier, which can be used to identify the task globally.
  - `projectPhase` TimeEntryPhasePublicAPIResponseEntity — Project phase associated with the time entry
    - `phaseId` integer — The unique identifier for the phase.
    - `phaseName` string — The name of the phase.
  - `createdAt` integer — Timestamp of creation time of the entry in epoch milliseconds
  - `updatedAt` integer — Timestamp of last updated time of the entry in epoch milliseconds
  - `createdBy` TimeEntryCreatedByPublicResponse — The team member who created the time entry.
    - `emailId` string — The user's email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `updatedBy` TimeEntryUpdatedByPublicResponse — The team member who updated the ttime entry.
    - `emailId` string — The user's email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `billable` boolean — Whether the time entry is billable. Defaults to true
  - `user` UserPublicAPIResponseEntity — User associated with the time entry
    - `emailId` string — The user's email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `notes` string — Notes for the time entry
  - `category` TimeEntryCategoryPublicAPI — Category associated with the time entry
    - `categoryName` string — The name of the category.
    - `categoryId` integer — The unique identifier for the category.
  - `sourceType` 'GOOGLE_CALENDAR' | 'OUTLOOK_CALENDAR' | 'TASK' | 'PROJECT' | 'PHASE' | 'ADHOC' | 'MILESTONE' — Type of source of the time entry Eg: Task, Adhoc (Activity), Milestone
  - `status` 'NOT_SUBMITTED' | 'SUBMITTED' | 'APPROVED' | 'REJECTED' — Status of the time entry
  - `submittedBy` TimeEntrySubmittedByPublicResponse — User who submitted the time entry Note: This field may be null, even when the time entry is in an APPROVED or REJECTED state, as time entries can be approved or rejected without an explicit submission step.
    - `emailId` string — The user's email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `submittedAt` integer — Time of submission for time entry Note: This field may be null, even when the time entry is in an APPROVED or REJECTED state, as time entries can be approved or rejected without an explicit submission step.
  - `approvedBy` TimeEntryApprovedByPublicResponse — User who approved the time entry
    - `emailId` string — The user's email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `approvedAt` integer — Time of approval for time entry
  - `rejectedBy` TimeEntryRejectedByPublicResponse — User who rejected the time entry
    - `emailId` string — The user's email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `rejectedAt` integer — Time of rejection for time entry
  - `deleted` boolean — Whether the time entry is deleted.
  - `costRate` TimeEntryCostRatePublicAPI — The hourly rate assigned to employees for the work they perform for your organization
    - `rate` number — The monetary amount assigned to a specific service or activity.
    - `currency` string — The three-letter ISO currency code representing the currency in which transactions are conducted.
  - `billRate` TimeEntryBillRatePublicAPI — The hourly rate charged to customers for the projects or services provided.
    - `rate` number — The monetary amount assigned to a specific service or activity.
    - `currency` string — The three-letter ISO currency code representing the currency in which transactions are conducted.
  - `fields` TimeEntryFieldPublicResponseAPIEntity[] — Custom fields associated with the time entry
    - `fieldId` integer — The unique identifier for the field.
    - `fieldLabel` string — The label of the field.
    - `fieldValue` object — The `fieldValue` is the value provided while creation or updating. The fieldValue can be a string, an integer, or an array and it must match the type of the field.
    - `fieldValueLabel` string — The `fieldValueLabel` is the value provided while creation or updating in a String format.

## Other responses

- `400` — This error typically happens when the request payload contains an error. If you want to make sure that the request's parameters are named correctly and are the right data types, you can examine the request's syntax.
- `401` — You see this error when trying to access this resource without being authenticated. Check the API request header to make sure it is not empty and has a valid api-key that you acquired from the Rocketlane API Settings tab.
- `404` — If we were unable to locate the resource you were looking for or the proper API endpoint you were looking for, this error would show up.

---

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