Skip to main content
GET
/
api
/
public
/
v1
/
timesheets
List Timesheets
curl --request GET \
  --url https://api.example.com/api/public/v1/timesheets
{
  "data": [
    {
      "id": "clq123...",
      "userId": "usr_789...",
      "companyId": "comp_456...",
      "periodStart": "2026-05-11T00:00:00.000Z",
      "periodEnd": "2026-05-17T23:59:59.999Z",
      "status": "APPROVED",
      "entries": [
        {
          "id": "ent_111...",
          "date": "2026-05-11T00:00:00.000Z",
          "hoursWorked": 8,
          "expectedHours": 8,
          "notes": "Standard shift"
        }
      ]
    }
  ]
}
You can filter the results using query parameters to find timesheets for specific users, within date ranges, or by approval status.

​
Query Parameters

​
userId
string
Filter timesheets by a specific employee’s unique User ID.
​
status
string
Filter timesheets by their approval status (e.g., DRAFT, SUBMITTED, APPROVED, REJECTED).
​
startDate
string
Filter timesheets where the period start date is greater than or equal to this date (ISO 8601 format).
​
endDate
string
Filter timesheets where the period end date is less than or equal to this date (ISO 8601 format).

​
Response

{
  "data": [
    {
      "id": "clq123...",
      "userId": "usr_789...",
      "companyId": "comp_456...",
      "periodStart": "2026-05-11T00:00:00.000Z",
      "periodEnd": "2026-05-17T23:59:59.999Z",
      "status": "APPROVED",
      "entries": [
        {
          "id": "ent_111...",
          "date": "2026-05-11T00:00:00.000Z",
          "hoursWorked": 8,
          "expectedHours": 8,
          "notes": "Standard shift"
        }
      ]
    }
  ]
}