Labor API Overview
Capture team member working hours with breaks and an hourly pay rate.
The Labor API is the timekeeping component of the suite of Team Management APIs provided by Square. Use the Labor API to integrate Square Point of Sale timekeeping with applications for labor cost reporting, payroll, and overtime management. The Labor API can also be used to integrate a time-clock application with a Square account for Seller Dashboard labor reporting or Square Payroll. The API supports multiple breaks per shift. Use the Team API to set multiple wage levels per team member.
The Labor API can be used to record team member labor hours or import and export timekeeping data to applications. Shift records created by the API are visible in the Shifts application in the Seller Dashboard. The Workday and Labor & tips pages show the work day hours completed and recorded by the API shift records as shown in the following figure:
Create a timekeeping application for Square account team members by providing the following:
Record the start time, end time, and breaks for a team member's work shift to compensate the team member for the actual time worked.
Set an hourly wage rate for a shift based on the job that a team member is doing on that shift.
Set break templates with a human-readable title, default duration, and payroll status to standardize team member shifts.
Import and export team member labor hours for time-clock, labor and sales reporting, and overtime management solutions by providing the following:
Export Square account labor hours. Use the Labor API shift search endpoint to get labor hours data in a pay period for use in an existing payroll system.
Import timekeeping data. Track team member labor hours in an existing time-clock application and import the data into a Square account as
Shiftrecords. Generate labor and sales reports in the Seller Dashboard or pay team members using Square Payroll.
The Labor API is available for server-side development as a set of REST endpoints.
A shift is a record of a team member's start time and end time for a work period on a specific day. A shift records the hourly pay rate for the work period and the duration of any breaks taken.
Applications using OAuth require the following permissions:
Retrieving team members:
Retrieving workweek configurations, team member wages, and break types:
Creating, updating, retrieving, and deleting shifts:
The Labor API also has the following limitations:
The Labor API cannot be used to assign job-based wages to a team member.
The Labor API cannot be used to create new team members.
If you need more assistance, contact Developer Support or ask for help in the Developer Forums.