> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftsheet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Timesheets

> Retrieve a list of timesheets for your company.

You can filter the results using query parameters to find timesheets for specific users, within date ranges, or by approval status.

### Query Parameters

<ParamField query="userId" type="string">
  Filter timesheets by a specific employee's unique User ID.
</ParamField>

<ParamField query="status" type="string">
  Filter timesheets by their approval status (e.g., `DRAFT`, `SUBMITTED`, `APPROVED`, `REJECTED`).
</ParamField>

<ParamField query="startDate" type="string">
  Filter timesheets where the period start date is greater than or equal to this date (ISO 8601 format).
</ParamField>

<ParamField query="endDate" type="string">
  Filter timesheets where the period end date is less than or equal to this date (ISO 8601 format).
</ParamField>

### Response

<ResponseExample>
  ```json theme={null}
  {
    "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"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>