Zoho People icon

Zoho People

Consume Zoho People API

Timesheet → Get Timesheets

AI-generated

Summary

Retrieve timesheet records for a specified user within optional date ranges and filtering criteria, returning detailed timesheet data.

Inputs

  • User (required) — Specify the user whose timesheets to fetch. Accepts the literal 'all' for all users, or a specific user identifier such as Email ID, Employee ID, or Erec No.
  • Additional Options — Optional filters and parameters including approval status, date format, employee status, date range ('From Date' and 'To Date'), pagination controls ('Limit' and 'Start Index'). See individual options for details.

Output shape

a list of timesheet records matching the specified filters and pagination parameters

The response can be paginated by using 'Limit' to set the maximum number of items returned and 'Start Index' to control the offset. The date format can be customized or will default to the company format if left empty. Approval status and employee status filters allow fine-grained control over which timesheets are retrieved.

Examples

Example 1: Fetch all timesheets for a specific employee between January and March 2024, only approved entries.

User set to the employee's identifier; 'Approval Status' set to 'Approved'; 'From Date' set to '01-Jan-2024'; 'To Date' set to '31-Mar-2024'.

Example 2: Retrieve all timesheets for all users with pending approval status, limiting to 100 records starting from the 0th index.

User set to 'all'; 'Approval Status' set to 'Pending'; 'Limit' set to 100; 'Start Index' set to 0.

Discussion