Returns time card approvals

get

https://api.hcssapps.com/heavyjob/api/v1/timeCardApprovalInfo

This call returns a paginated list of time card summary information with approvals for the specified job, foreman, and date range.
If there are additional pages, the response metadata will include a "nextCursor" field. That field should be passed as the "cursor" query parameter to request the next page of results.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

jobId

uuid

The job guid. If omitted, returns time cards across all jobs.

foremanId

uuid

The foreman guid. If omitted, returns time cards across all foremen.

employeeId

uuid

If specified, returns only time cards having this employee.

startDate

date-time

The start date in yyyy-MM-dd format. If omitted, returns time cards from the beginning of time. (bounded by the end date).

endDate

date-time

The end date in yyyy-MM-dd format. If omitted, returns time cards until the end of time. (bounded by the start date).

modifiedSince

date-time

If specified, returns only records that have been modified since this time. In RFC-3339 format. (yyyy-MM-ddThh:mm:ssZ) Or (yyyy-MM-ddThh:mm:ss.FFFFFFFZ)

cursor

string

Optional. When there are additional results, the metadata nextCursor field should be passed to retrieve the next page of results.

limit

int32

Defaults to 1000

The maximum number of results that should be returned.

isApproved

boolean

Optional. When set, returns only time cards with a status of approved.

isAccepted

boolean

Optional. When true, returns only time cards with a status of accepted.
This combines with isApproved and isReviewed parameters with AND logic.

isReviewed

boolean

Optional. When true, returns only time cards with a status of accepted.
This combines with isAccepted and isApproved parameters with AND logic.

businessUnitId

uuid

Optional. The business unit ID. If omitted, returns time cards for all business units.

Responses

400

Bad Request. See https://developer.hcssapps.com/getting-started/troubleshoot-bad-request for more information.

401

Unauthorized. See https://developer.hcssapps.com/getting-started/troubleshoot-unauthorized for more information.

403

Forbidden. See https://developer.hcssapps.com/getting-started/troubleshoot-forbidden for more information.

200OK