List User Times
/user_times
A list of all times for a user within a given date range
Get User Times [GET]
Get a list of users times (clock-in/clock-out) for a given time period
Authorization: Admin
Parameters
- startTime = yyyy-mm-dd (required, date,
startTime=2022-05-22) ... Get all times for the users after this startTime. - endTime = yyyy-mm-dd (required, date,
endTime=2022-09-22) ... Get all times for the users after the startTime and before this endTime. - userIds = (optional, list of integers,
userIds=1&userIds=2) ... The user or users you want the times for. Do not include this parameter if you want all the users times between the dates entered. - folderId = (optional, integers,
folderId=123) ... only return times that were assigned to this folder.
Response 200
Body
{
"page": 1,
"pages": 1,
"count": 2,
"items": [
{
"user": {
"id": 123,
"firstName": "John",
"lastName": "Doe",
"employeeNumber": "HR123",
},
"id": 157913,
"note": "This was the start of my shift",
"startTime": "2024-06-19T16:16:07.260Z",
"endTime": null,
"lunchDurationMinutes": null,
"userTimeCategoryId": 1,
"userTimeCategory": {
"code": "101",
"id": 1,
"name": "Billable",
"color": "589d46",
"ordinal": 0
},
"folder": null,
"startLatitude": 33.434562,
"endLatitude": null,
"startLongitude": -84.908446,
"endLongitude": null,
"offsetInMinutes": -240,
"status": null,
"folderId": null,
"hoursLogged": null,
"minutesLogged": null
},
{
"user": {
"id": 123,
"firstName": "John",
"lastName": "Doe",
"employeeNumber": "HR123",
},
"id": 157912,
"note": null,
"startTime": "2024-06-19T16:12:46.480Z",
"endTime": "2024-06-19T16:15:36.050Z",
"lunchDurationMinutes": null,
"userTimeCategoryId": 1,
"userTimeCategory": {
"code": "101",
"id": 1,
"lastModified": "0001-01-01T00:00:00.000Z",
"name": "Billable",
"color": "589d46",
"ordinal": 0
},
"folder": {
"id": 2022143,
"num": "BR1084"
},
"startLatitude": 33.434562,
"endLatitude": 33.434562,
"startLongitude": -84.908446,
"endLongitude": -84.908446,
"offsetInMinutes": -240,
"status": null,
"folderId": 2022143,
"hoursLogged": 0,
"minutesLogged": 2
}
],
"userTimeSummary": [
{
"id": 1,
"color": "589d46",
"name": "Billable",
"breakMinutes": 0,
"hoursLogged": 0,
"minutesLogged": 2
}
]
}