Routes
Tasks
Labor

This request gets the labor (time spent) on a Task. A single Task can have multiple times logged onto it.

Return data description

PropertyDescription
metaThis property contains shortcuts to other requests that can be used to get more information regarding the Task the labor was logged on and the user who logged the time.
taskIDThe Task ID associated with this labor entry.
timeSpentThe amount of time measure in seconds.
userWageThe wage per hour.
descriptionA description of the labor entry.
dateLoggedThe date that this time was logged on the Task.
billableTimeThe amount of time that is billable for this Task.
billableRateThe rate at which this labor entry is billed at.
categoryIDThe labor category this entry is associated with.
taskNameThe name of the task associated with this labor entry.
taskPriorityIDThe Priority ID of the task this labor entry is associated with.
taskPriorityLevelThe Priority value of the task this labor entry is associated with.
get/v2/tasks/labor

Request

Query parameters

tasksstring

This parameter is used to only get specific Tasks. This parameter accepts a comma delimited list of task IDs.

usersinteger

This parameter is used to only get labor records for a specific user or set of users in a comma delimited list.

startinteger

This parameter is used to only get labor that was logged after the unix timestamp passed into the start parameter. For example, all Assets that were last edited after April 18th, 2018.

endinteger

This parameter is used to only get labor that was logged before the unix timestamp passed into the end parameter.

limitinteger

This parameter is a result limiter. The default is set to return no more than 100 results at one time. Maximum allowed value is 1000.

cursorinteger

This parameter is a cursor that selects what taskID you want to start receiving results at. e.g. passing 137 here will only get you tasks with an id greater than 137.

locationsinteger

This parameter is used to retrieve labor entries for particular locations. This parameter accepts a comma delimited list of location IDs.

orderBystring

This parameter is used to order results by their dateLogged property instead of the default ordering. CANNOT be provided alongside the cursor parameter. to paginate in this ordering, use the start or end parameters.

Response

Task Labor

userIDinteger
timeSpentinteger
userWageinteger
taskIDinteger
taskNamestring
tashPriorityIDinteger
descriptionunknown
dateLoggedinteger
billableTimeunknown
billableRateunknown
categoryIDunknown

Changes

    • warning

      for the query request parameter limit, the max was set to 1000.00

    • warning

      for the query request parameter limit, the min was set to 1.00

    • info

      added the non-success response with the status