List timesheets
Timesheets of a pay period with each employee's submission and approval state and total hours.
GET https://cotlet.dev/api/v1/connecteam/time-clocks/{time_clock_id}/timesheets
read
Returns one row per employee for the dates you pass, as the Timesheets tab shows them: submission is submitted or not_submitted (the User Submission column), approval is approved or not_approved, and total_hours is the sum for the period. Filter with status. Pass next_cursor back as cursor for the next page. Approving works for a pay period, so pass its first and last day.
Parameters
| Name | Type | Description |
|---|---|---|
| time_clock_id integer required | integer | Time clock ID from list_time_clocks. |
| 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. |
| status enum | enum | all (default), submitted, not_submitted or approved. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/connecteam/time-clocks/1/timesheets?period_start=2026-10-01&period_end=2026-10-01" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("connecteam", "list_timesheets", {"time_clock_id":1,"period_start":"2026-10-01","period_end":"2026-10-01"})const result = await cotlet.call('connecteam', 'list_timesheets', {"time_clock_id":1,"period_start":"2026-10-01","period_end":"2026-10-01"});cotlet call connecteam list_timesheets --data '{"time_clock_id":1,"period_start":"2026-10-01","period_end":"2026-10-01"}'Example response
{
"time_clock_id": 2041,
"period_start": "2026-10-12",
"period_end": "2026-10-18",
"timesheets": [
{
"user_id": 8821034,
"name": "Dana Whitfield",
"submission": "submitted",
"approval": "not_approved",
"total_hours": 38.5
},
{
"user_id": 8821051,
"name": "Luis Ortega",
"submission": "submitted",
"approval": "not_approved",
"total_hours": 41
},
{
"user_id": 8821077,
"name": "Priya Nair",
"submission": "not_submitted",
"approval": "not_approved",
"total_hours": 36.25
}
],
"next_cursor": null
}