Get a timesheet
One employee's timesheet day by day, with clock in, clock out, hours and locked days.
GET https://cotlet.dev/api/v1/connecteam/time-clocks/{time_clock_id}/timesheet
read
Returns the days of one employee in the dates you pass, in date order, each with its time entries (clock_in, clock_out), the hours for the day and whether the day is locked. total_hours is the sum of the days. Read it before approve_timesheet to judge the hours.
Parameters
| Name | Type | Description |
|---|---|---|
| time_clock_id integer required | integer | Time clock ID from list_time_clocks. |
| user_id integer required | integer | User ID from list_users or list_timesheets. |
| period_start date required | date | First day of the pay period, YYYY-MM-DD. |
| period_end date required | date | Last day of the pay period, YYYY-MM-DD. |
Request
curl "https://cotlet.dev/api/v1/connecteam/time-clocks/1/timesheet?user_id=1&period_start=2026-10-01&period_end=2026-10-01" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("connecteam", "get_timesheet", {"time_clock_id":1,"user_id":1,"period_start":"2026-10-01","period_end":"2026-10-01"})const result = await cotlet.call('connecteam', 'get_timesheet', {"time_clock_id":1,"user_id":1,"period_start":"2026-10-01","period_end":"2026-10-01"});cotlet call connecteam get_timesheet --data '{"time_clock_id":1,"user_id":1,"period_start":"2026-10-01","period_end":"2026-10-01"}'Example response
{
"user_id": 8821051,
"name": "Luis Ortega",
"period_start": "2026-10-12",
"period_end": "2026-10-18",
"days": [
{
"date": "2026-10-12",
"entries": [
{
"clock_in": "08:00",
"clock_out": "16:00"
}
],
"hours": 8,
"locked": false
},
{
"date": "2026-10-13",
"entries": [
{
"clock_in": "08:00",
"clock_out": "16:30"
}
],
"hours": 8.5,
"locked": false
},
{
"date": "2026-10-14",
"entries": [
{
"clock_in": "07:30",
"clock_out": "17:00"
}
],
"hours": 9.5,
"locked": false
},
{
"date": "2026-10-15",
"entries": [
{
"clock_in": "08:00",
"clock_out": "16:00"
}
],
"hours": 8,
"locked": false
},
{
"date": "2026-10-16",
"entries": [
{
"clock_in": "09:00",
"clock_out": "16:00"
}
],
"hours": 7,
"locked": false
}
],
"total_hours": 41
}