Actions6
- Invoice Line Actions
- Timesheet Actions
- User Actions
Timesheet → Get By Period
AI-generatedSummary
Retrieve timesheets for a specific user within a given date range.
Inputs
- Username (required) — The username to retrieve timesheets for. You must provide a username obtained, for example, via the User > Get Many operation.
- Start Date (required) — Start date of the period in YYYY-MM-DD format; timesheets from this date onward are returned.
- End Date (required) — End date of the period in YYYY-MM-DD format; timesheets up to this date are returned.
- Additional Fields — Optional settings: 'Return All' to get all matching timesheets, or 'Limit' to specify the maximum number of results returned (default 10, max 500).
Output shape
a list of timesheet objects matching the specified username and period
The operation returns an array of timesheet JSON objects. By default, it returns up to the specified limit (default 10). If 'Return All' is enabled, all matching timesheets are returned regardless of count. If no username is provided, execution throws an error.
Examples
Example 1: Get timesheets for user 'jdoe' between 2024-01-01 and 2024-01-31, limiting results to 20
Set Username to 'jdoe', Start Date to '2024-01-01', End Date to '2024-01-31', enable Return All to false and Limit to 20.