Labor Punches

Prev Next
Get
/public/v1/labor/labor-punches

Retrieves a paginated list of labor punches. At least one date range (DateOfBusiness or ModifiedOn) must be supplied

Security

The requesting user must have both of the following:

  • Labor → Punch Edits → Add/Edit/Delete Labor Punches or Labor → Employees → Time → View Punches
  • Labor → Employees → Employment → Hourly Pay Rates → View Hourly Pay Rates or Labor → Employees → Employment → Salary Pay Rates → View Salary Pay Rates
Security
HTTP
Type Bearer
Header parameters
x-r365-context-tenant-id
stringRequired

Identifies the R365 tenant the request applies to. Required on every request.

Query parameters
dateOfBusinessStart
string (date)

Start of the date-of-business range, inclusive (yyyy-MM-dd). When supplied alone, scopes the query to that single day

dateOfBusinessEnd
string (date)

End of the date-of-business range, inclusive (yyyy-MM-dd). When supplied alone, scopes the query to that single day

modifiedOnStart
string (date-time)

Start of the modified-on range, inclusive (UTC). When supplied alone, scopes the query to that single day

modifiedOnEnd
string (date-time)

End of the modified-on range, inclusive (UTC). When supplied alone, scopes the query to that single day

locations
array of string

Optional list of location identifiers to filter by. When omitted, all locations the caller has access to are returned

legalEntities
array of string

Optional list of legal entity identifiers to filter by. When omitted, all legal entities the caller has access to are returned. Combined with locations as an additional AND filter

pageSize
integer (int32)

Maximum number of top-level objects to return in one page.

Minimum1.0
Maximum250.0
Default250
continuationToken
string

Opaque continuation token from a prior response NextLink. Omit on the first request; required to fetch each subsequent page. An invalid token returns HTTP 422

Responses
200

OK

Expand All
object
data
Array of object | null

Labor punches for the requested page.

object
laborId
string (uuid)

Unique identifier of the labor punch.

dateWorked
string (date)

Date worked (date of business).

startTime
string (date-time) | null

Punch-in time (UTC).

endTime
string (date-time) | null

Punch-out time (UTC).

hours
number (double) | null

Hours worked.

payRate
number (double) | null

Pay rate applied to the punch.

total
number (double) | null

Gross pay for the punch (hours multiplied by pay rate).

tipDeclaredAmount
number (double) | null

Employee-declared tip amount on the punch.

employee
object (EmployeeRef)
id
string (uuid)

R365 employee identifier.

name
string | null

Employee display name.

payrollId
string | null

Employee payroll identifier from the external payroll provider.

job
object (JobRef)
id
string (uuid)

Job title identifier.

name
string | null

Job title name.

code
string | null

Job code value.

department
string | null

Department name the job belongs to.

location
object (LaborPunchEntityReference)
id
string (uuid)

Location identifier.

name
string | null

Location name.

number
string | null

Location number.

createdOn
string (date-time) | null

Date and time the record was created (UTC).

createdBy
object (UserRef)
id
string (uuid)

User identifier.

name
string | null

User full name.

modifiedOn
string (date-time) | null

Date and time the record was last modified (UTC).

modifiedBy
object (UserRef)
id
string (uuid)

User identifier.

name
string | null

User full name.

nextLink
string | null

Relative URL to retrieve the next page of results. Preserves the original query parameters and appends a fresh continuationToken. Null when this is the last page.

Expand All
object
data
Array of object | null

Labor punches for the requested page.

object
laborId
string (uuid)

Unique identifier of the labor punch.

dateWorked
string (date)

Date worked (date of business).

startTime
string (date-time) | null

Punch-in time (UTC).

endTime
string (date-time) | null

Punch-out time (UTC).

hours
number (double) | null

Hours worked.

payRate
number (double) | null

Pay rate applied to the punch.

total
number (double) | null

Gross pay for the punch (hours multiplied by pay rate).

tipDeclaredAmount
number (double) | null

Employee-declared tip amount on the punch.

employee
object (EmployeeRef)
id
string (uuid)

R365 employee identifier.

name
string | null

Employee display name.

payrollId
string | null

Employee payroll identifier from the external payroll provider.

job
object (JobRef)
id
string (uuid)

Job title identifier.

name
string | null

Job title name.

code
string | null

Job code value.

department
string | null

Department name the job belongs to.

location
object (LaborPunchEntityReference)
id
string (uuid)

Location identifier.

name
string | null

Location name.

number
string | null

Location number.

createdOn
string (date-time) | null

Date and time the record was created (UTC).

createdBy
object (UserRef)
id
string (uuid)

User identifier.

name
string | null

User full name.

modifiedOn
string (date-time) | null

Date and time the record was last modified (UTC).

modifiedBy
object (UserRef)
id
string (uuid)

User identifier.

name
string | null

User full name.

nextLink
string | null

Relative URL to retrieve the next page of results. Preserves the original query parameters and appends a fresh continuationToken. Null when this is the last page.

Expand All
object
data
Array of object | null

Labor punches for the requested page.

object
laborId
string (uuid)

Unique identifier of the labor punch.

dateWorked
string (date)

Date worked (date of business).

startTime
string (date-time) | null

Punch-in time (UTC).

endTime
string (date-time) | null

Punch-out time (UTC).

hours
number (double) | null

Hours worked.

payRate
number (double) | null

Pay rate applied to the punch.

total
number (double) | null

Gross pay for the punch (hours multiplied by pay rate).

tipDeclaredAmount
number (double) | null

Employee-declared tip amount on the punch.

employee
object (EmployeeRef)
id
string (uuid)

R365 employee identifier.

name
string | null

Employee display name.

payrollId
string | null

Employee payroll identifier from the external payroll provider.

job
object (JobRef)
id
string (uuid)

Job title identifier.

name
string | null

Job title name.

code
string | null

Job code value.

department
string | null

Department name the job belongs to.

location
object (LaborPunchEntityReference)
id
string (uuid)

Location identifier.

name
string | null

Location name.

number
string | null

Location number.

createdOn
string (date-time) | null

Date and time the record was created (UTC).

createdBy
object (UserRef)
id
string (uuid)

User identifier.

name
string | null

User full name.

modifiedOn
string (date-time) | null

Date and time the record was last modified (UTC).

modifiedBy
object (UserRef)
id
string (uuid)

User identifier.

name
string | null

User full name.

nextLink
string | null

Relative URL to retrieve the next page of results. Preserves the original query parameters and appends a fresh continuationToken. Null when this is the last page.

400

Bad Request — a parameter value is malformed, of the wrong type, or outside its allowed range.

401

Unauthorized — the bearer token is missing, invalid or expired, or is not valid for the specified tenant.

403

Forbidden — the caller lacks the permission required for this operation.

404

Not Found — the requested resource does not exist, or the supplied continuation token is unknown or has expired.

409

Conflict — the request conflicts with the current state of the resource and cannot be applied.

422

Unprocessable Entity — a required parameter is missing, or a supplied parameter value is invalid.

429

Too Many Requests — the caller has exceeded the rate limit; retry after a short delay.

500

Internal Server Error — an unexpected error occurred while processing the request.