TIA icon

TIA

Interact with the TIA API for timesheets, users, and invoice lines

Actions6

Timesheet → Get By Period

AI-generated

Summary

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.

Links

Discussion