List timesheets
Timesheets of a location, oldest first, pending or approved.
GET https://cotlet.dev/api/v1/deputy/locations/{location_id}/timesheets
read
Returns timesheets of one location in date order, oldest first, the order Deputy recommends for approval. status pending (default) lists those waiting for approval, approved lists the done ones. Each row has start, end and break, and a missing end time is shown as null. Pay figures need the Location Manager or System Administrator role.
Parameters
| Name | Type | Description |
|---|---|---|
| location_id integer required | integer | Location ID from list_locations. |
| status enum | enum | pending (default) or approved. |
| date_from date | date | First day, YYYY-MM-DD. |
| date_to date | date | Last day, YYYY-MM-DD. |
| employee_id integer | integer | Only this employee's timesheets. |
Request
curl https://cotlet.dev/api/v1/deputy/locations/1/timesheets \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("deputy", "list_timesheets", {"location_id":1})const result = await cotlet.call('deputy', 'list_timesheets', {"location_id":1});cotlet call deputy list_timesheets --data '{"location_id":1}'Example response
{
"timesheets": [
{
"timesheet_id": 4821,
"employee": "Ana Lopez",
"date": "2026-10-12",
"start": "09:00",
"end": "17:30",
"break_minutes": 30,
"hours": 8,
"status": "pending"
},
{
"timesheet_id": 4822,
"employee": "Tom Becker",
"date": "2026-10-12",
"start": "10:00",
"end": null,
"break_minutes": 0,
"hours": null,
"status": "pending"
}
]
}