# List Timesheet Entries

Gets a paginated list of timesheet entries recorded for a given time period with optional filtering by project offering, approval status, and etc. When no start or end date filters are provided, returns entries from the last 7 days (7 days ago through today).

Endpoint: GET /v1/timesheet-entries
Version: v1
Security: ApiKey

## Query parameters:

  - `page` (integer)
    The specific page of results requested.

  - `page_size` (integer)
    The number of results in each page.

  - `start_date` (string)
    Filter by entries recorded on or after this date. When not provided, defaults to 7 days ago from today. Currently, this endpoint requires the queried date range to not exceed 31 days. You must specify an end date filter when specifying this value. ISO date formatting expected (yyyy-MM-dd)

  - `end_date` (string)
    Filter by entries recorded on or before this date. When not provided, defaults to today. You must specify an start date filter when specifying this value. ISO date formatting expected (yyyy-MM-dd)

  - `approval_status` (string)
    Enum: "open", "submitted", "approved"

  - `approval_status_start_date` (string)
    Optional filter for entries with an approval status change on or after this date. Currently, this endpoint requires the queried date range to not exceed 31 days. You must specify an approval status end date filter when specifying this value. ISO date formatting expected (yyyy-MM-dd)

  - `approval_status_end_date` (string)
    Optional filter for entries with an approval status change on or before this date. You must specify an approval status start date filter when specifying this value. ISO date formatting expected (yyyy-MM-dd)

  - `project_id` (string)
    The id of the project in which the time entry belongs to.

  - `project_offering_id` (string)
    The id of the project offering in which the time entry belongs to.

## Response 200 fields (application/json):

  - `count` (integer)
    The number of results in the current page.

  - `total` (integer)
    The total number of results that fulfill the request.

  - `page` (integer)
    The current page of results being returned.

  - `total_pages` (integer)
    The total number of available pages that fulfill the request.

  - `page_size` (integer)
    The number of results in each page returned.

  - `results` (array, required)
    The array of result objects for the current page.

  - `results.id` (string)
    The id of the time entry.

  - `results.submission_id` (string)
    The id of the submission in which the time entry belongs to.

  - `results.submission_start_date` (string)
    The start date of the submission (period) this time entry belongs to.

  - `results.submission_end_date` (string)
    The end date of the submission (period) this time entry belongs to.

  - `results.approval_status` (object)

  - `results.approval_status_date` (string)
    The date and time at which the timesheet's approval status changed to its current value.

  - `results.person_id` (string)
    The id of the Person in which the actual time entry belongs to.

  - `results.client_id` (string,null)
    The unique identifier of the client in Parallax.

  - `results.project_id` (string)
    The id of the project in which the time entry belongs to.

  - `results.project_offering_id` (string)
    The id of the project offering in which the time entry belongs to.

  - `results.project_offering_role_id` (string)
    The id of the project offering role that the actual time is recorded to.

  - `results.note` (string,null)
    Notes associated with the time entry.

  - `results.date` (string)
    The date in which the time entry is recorded to, in the YYYY-MM-DD format.

  - `results.hours` (number)
    The number of hours associated with the time entry.

  - `results.is_billable` (boolean)
    Indicates whether the time entry was for billable work.

## Response 400 fields (application/json):

  - `type` (string)
    RFC reference for the error type

  - `title` (string)
    Human-readable summary of the error

  - `status` (integer)
    HTTP status code

  - `errors` (array)
    Detailed error messages for each validation failure

  - `trace_id` (string)
    Trace identifier for debugging