Logged Time Entries
This documentation is for LiquidPlanner New: next.liquidplanner.com
Best Practice for Pulling Logged Time Entries
If you are pulling time entries into a system of record we recommend establishing a business rule to ensure that time entries have been updated within the app prior to pulling them via the API.
Pull raw data about logged time entries in JSON format. Each time entry row represents time tracked to a Task by Assignment by Cost Code, by day.
The data response received will include the raw time entry data in JSON format as shown in the example below. You can then map that data to the cost code name, item name and user name by calling those respective endpoints and cross-referencing the data returned.
The logged value is pulled in minutes. Convert it to hours, if needed, to match the value as displayed in-app.
https://next.liquidplanner.com/api/workspaces/<workspace id>/logged-time-entries/v1
Supported Methods
GET
Sample Response
{
"recordLimit": 500,
"recordCount": 1,
"data": [
{
"id": 364183,
"date": "2022-07-04",
"note": “this is a time entry note sample”,
"loggedEntriesInMinutes": 480,
"costCodeId": null,
"itemId": 424982,
"userId": 10702,
"createdAt": "2022-08-03T18:12:37.937375Z",
"updatedAt": "2022-08-03T18:12:37.941Z",
"createdBy": 10702,
"updatedBy": 10702
}
]
}
Filter Options
Apply the filter string to the endpoint URL.
Filter attribute | Field type | Description | Filter string | Note |
---|---|---|---|---|
id | number | Pull details about a specific logged time entry its ID | ?id[is]="122" | |
itemId | number | Pull time entries made on a specific assignment by assignment ID | ?itemId[is]="425268" | |
date | date | Pull time entries in a given date range | ?date[in]=["2022-07-04","2022-07-05"] | Encode operator and value. Date value doesn’t need a timestamp |
userId | number | Pull time entries for a specific user | ?userId[is]="62" | |
costCodeId | number | Pull a list of time entries made against the specified cost code | ?costCodeId[in]=["223","571"] | Encode operator and value |
updatedAt | dateTime | Pull time entries based on when they were updated | ?updatedAt[gte]=”2022-08-14T00:00:00.0Z” | |
createdAt | dateTime | Pull time entries that were created in a given date range | ?createdAt[between]=["2021-12-03T10:15:30.00Z","2021-12-05T10:15:30.00Z"] | Encode operator and value. |
Updated 7 months ago