---
title: "Retrieves a paginated list of timesheet entries with rich filtering by date range, user, project, task, category, billable/invoiced status, approval status, and running timer state."
method: GET
path: "/api/Timesheet"
tags: ["Timesheet"]
---

# Retrieves a paginated list of timesheet entries with rich filtering by date range, user, project, task, category, billable/invoiced status, approval status, and running timer state.

`GET /api/Timesheet`

## Query parameters

- `UpdatedAfter` string, date-time
- `EntryDateFrom` string, date-time
- `EntryDateTo` string, date-time
- `UserID` integer
- `UserEmail` string
- `CategoryName` string
- `TimesheetEntryApprovalStatusCode` string
- `ProjectID` integer
- `TaskID` integer
- `isBillable` boolean
- `isInvoiced` boolean
- `isTimerRunning` boolean
- `pageSize` integer
- `pageNumber` integer
- `includeInvoiceDetails` boolean
- `Sort` string

## Response `200`

Returns a paginated list of timesheet entries with full details.

- TimesheetList — Paginated collection of timesheet entries.
  - `Timesheets` TimesheetListDetails[] — The list of timesheet entries for the current page.
    - `TimesheetEntryID` integer — Unique identifier for the timesheet entry.
    - `UserIDFK` integer — The ID of the user who owns this timesheet entry.
    - `Firstname` string — First name of the timesheet user.
    - `Lastname` string — Last name of the timesheet user.
    - `Email` string — Email address of the timesheet user.
    - `ProjectIDFK` integer — The project ID this timesheet entry is associated with.
    - `ProjectTitle` string — Title of the associated project.
    - `ProjectCode` string — Project code of the associated project, if project codes are enabled.
    - `CustomerIDFK` integer — The customer/company ID associated with the project.
    - `CustomerName` string — Name of the customer/company associated with the project.
    - `TimesheetCategoryIDFK` integer — The timesheet category ID applied to this entry.
    - `CategoryName` string — Name of the timesheet category applied to this entry.
    - `Duration` number, double — Duration of the timesheet entry in decimal hours.
    - `TimesheetEntryApprovalStatusCode` string — Approval status of the entry. Values: Draft, Pending, Approved, Rejected, AutoApproved.
    - `HasTimer` boolean — Whether a timer is currently running on this entry.
    - `TimerStartedAtUTC` string, date-time — The UTC date and time at which the timer was started, if a timer is running.
    - `isBillable` boolean — Whether this timesheet entry is billable to the client.
    - `isInvoiced` boolean — Whether this timesheet entry has been included on an invoice.
    - `EntryDate` string, date-time — The date of the timesheet entry.
    - `StartTimeLocal` string, date-time — The local start time of the entry, if start/end time tracking is enabled.
    - `StartTimeUTC` string, date-time — The UTC start time of the entry, if start/end time tracking is enabled.
    - `EndTimeLocal` string, date-time — The local end time of the entry, if start/end time tracking is enabled.
    - `EndTimeUTC` string, date-time — The UTC end time of the entry, if start/end time tracking is enabled.
    - `TimesheetUserTimeZone` string — The IANA time zone ID of the user who owns the timesheet.
    - `Notes` string — Free-text notes attached to this timesheet entry.
    - `TaskIDFK` integer — The task ID this timesheet entry is linked to, if any.
    - `TaskTitle` string — Title of the task this entry is linked to.
    - `SectionIDFK` integer — The section ID of the task this entry is linked to.
    - `SectionTitle` string — Title of the section the linked task belongs to.
    - `InvoiceIDFK` integer — This InvoiceIDFK is only included when the api get parameter includeInvoiceDetails==true
    - `InvoiceLineItemIDFK` integer — The invoice line item ID this entry was billed on, if invoiced.
    - `DateCreated` string, date-time — Date and time the record was created (UTC).
    - `DateUpdated` string, date-time — Date and time the record was last updated (UTC).
    - `DateApproved` string, date-time — Date and time the entry was approved, if applicable.
    - `ApprovedBy` string — Name or email of the user who approved this entry.
    - `CustomMetadata` string — Optional free-form metadata field for storing additional information. Maximum 1000 characters.
    - `RateAmount` number, double — Only visible to Admin role users
    - `CostAmount` number, double — Only visible to Admin role users
    - `ViewTimesheetURL` string — URL to view this timesheet entry's day in the Avaza web application.
  - `TotalCount` integer — Total number of timesheet entries matching the filter criteria.
  - `PageNumber` integer — The current page number (1-based).
  - `PageSize` integer — Number of results per page.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)