# Get All Timesheets

Retrieve all timesheets in your workspace. Supports filtering by status (open, submitted, rejected, approved), date range, and ID. Results are paginated.

Endpoint: GET /timesheets
Version: 2.0.0
Security: oauth2, apiKey

## Query parameters:

  - `workspace_id` (integer, required)
    ID of the workspace
    Example: 1

  - `id` (string)
    UUID of the timesheet
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `status` (string)
    Filter by timesheet status
    Enum: "open", "submitted", "rejected", "approved"

  - `date_from` (string)
    Filter timesheets from this date (YYYY-MM-DD)
    Example: "2024-01-01"

  - `date_to` (string)
    Filter timesheets to this date (YYYY-MM-DD)
    Example: "2024-01-31"

  - `page` (integer)
    Page number for pagination
    Example: 1

  - `per_page` (integer)
    Number of items per page (max 100)
    Example: 20

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (array)

  - `data.id` (string, required)
    UUID of the timesheet
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `data.user_id` (integer,null)
    ID of the user who owns this timesheet
    Example: 100

  - `data.date_from` (string,null)
    Start date of the pay period
    Example: "2024-01-01"

  - `data.date_to` (string,null)
    End date of the pay period
    Example: "2024-01-15"

  - `data.total_hours` (number,null)
    Total hours in the timesheet
    Example: 80.5

  - `data.submitted_on` (string,null)
    Timestamp when timesheet was submitted
    Example: "2024-01-15T10:30:00Z"

  - `data.reject_reason` (string,null)
    Reason for rejection (if rejected)
    Example: "Hours do not match project requirements"

  - `data.status` (string)
    Status of the timesheet
    Enum: "open", "submitted", "rejected", "approved"

  - `meta` (object)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)

## Response 400 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Error message describing what went wrong
    Example: "An error occurred"

  - `error` (string,null)
    Optional additional error details
    Example: "Internal Server Error"

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)

## Response 401 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Error message describing what went wrong
    Example: "An error occurred"

  - `error` (string,null)
    Optional additional error details
    Example: "Internal Server Error"

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)

## Response 403 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Error message describing what went wrong
    Example: "An error occurred"

  - `error` (string,null)
    Optional additional error details
    Example: "Internal Server Error"

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)

## Response 500 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Error message describing what went wrong
    Example: "An error occurred"

  - `error` (string,null)
    Optional additional error details
    Example: "Internal Server Error"

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)