Employment Hero Payroll API Reference
Home
About the API
API Key Authentication
OAuth2 Authentication
OData Filtering
.NET Client
Using the API
iFrame navigation
SSO Requests
Authentication
Summary
OAuth Token
Single Sign On
Single Sign On
Single Sign On
Brand
Summary
Active Employees Report
Cancel Business
Get Brand Label by ID
List Brand Labels
List Business Templates
Signup Report
Business
Summary
Assign Business Access
Change the tax year
Copy Business Settings From Template
Create Business Document
Create New Business
Create payslip configuration
Delete Business Document
Dismiss Business Notifications
Get Business Billing Plan
Get Business Details
Get Business Details by External ID
Get Business Document Content
Get Business Document Details
Get Employee Portal Settings
Get Rounding Rules
Get User Business Access
Get payslip configuration
Get the timesheet settings for the business
List All Business Access Users
List Billing Plans
List Business Document Details
List Business Notifications
List Businesses
List Entitlements
List the Business tags
Revoke Business Access
Set Business Billing Plan
Set Rounding Rules
Update Business Document Permissions
Update Employee Portal Settings
Update details of an associated user
Update the timesheet settings for the business
Chart of Accounts
Summary
Bulk insert Journal Accounts
Create a new Journal Account
Delete Employing Entity Specific Chart of Accounts
Delete Location Specific Chart of Accounts
Delete an existing Journal Account
Get Chart of Accounts
Get Employing Entity Specific Chart of Accounts
Get Journal Account Types
Get Journal Account by ID
Get Journal Accounts
Get Journal Service provider
Get Journal Service providers
Get Location Specific Chart of Accounts
Update Chart of Accounts
Update Employing Entity Specific Chart of Accounts
Update Journal Service provider
Update Location Specific Chart of Accounts
Update an existing Journal Account
Deduction Categories
Summary
Create Deduction Category
Delete Deduction Category
Get Deduction Category By ID
List Deduction Categories
Update Deduction Category
Dimensions
Summary
Create Dimension
Create Dimension Value
Delete Dimension
Delete Dimension Value
Get Dimension Value by ID
Get Dimension by ID
List Dimension Values
List Dimensions
Update Dimension
Update Dimension Value
Employee
Summary
Activate Employee
Create or Update Employee
Delete Employee
Delete Employee Profile Image
Get Employee By External ID
Get Employee By External Reference ID
Get Employee By ID
Get Employee Notes
Get Employee Profile Image
Get Employee Shift Conditions
Get Employee Work Types
Get Employee basic details by ID
Get Leave Balances
Get Opening Balances
Get Pay Rates
Get standard hours for employee
Grant Kiosk Access
List Employees
List basic details for employees
Revoke Kiosk Access
Set Employee Notes
Set Employee Profile Image
Set Opening Balances
Set standard hours for employee
Update Employee
Employee Access
Summary
Get Employee Access for User
Get Users With Access to Employee
Grant Employee Access
Revoke Employee Access
Update Employee Access Record
Employee Bank Accounts
Summary
Create Bank Account
Delete Bank Account
Get Bank Account by ID
List Bank Accounts
Update Bank Account
Employee Documents
Summary
Create Employee Document
Delete Employee Document
Get Employee Document Content
Get Employee Document Details
Link Employee Document to Expense Request
Link Employee Document to Leave Request
Link Employee Document to Timesheet
List Employee Documents
Unlink Employee Document from Expense Request
Unlink Employee Document from Leave Request
Unlink Employee Document from Timesheet
Update Employee Document Permissions
Employee Earnings Line Split
Summary
Create Earnings line split
Delete Earnings line split
Get Earnings line split by location ID
Get Employee location earnings line splits
Update Earnings line split
Employee Expense Categories
Summary
Create Employee Expense Category
Delete Employee Expense Category
Get Employee Expense Category by ID
Get Tax Codes
List Employee Expense Categories
Update Employee Expense Category
Employee Expense Requests
Summary
Approve Expense Request
Create Expense Request
Decline Expense Request
Delete Expense Request
Get Expense Request by ID
List Expense Requests
Update Expense Request
Upload Attachment to Expense Request
Employee Groups
Summary
Create Employee Group
Delete Employee Group
Get Employee Group by ID
List Employee Groups
Update Employee Group
Employee Leave Allowances
Summary
Get Leave Allowances
Set Leave Allowances
Employee Onboarding
Summary
Initiate Employee Self Setup
Employee Pay Rate Schedule
Summary
Create pay rate adjustment schedule record
Delete pay rate adjustment schedule record
Get pay rate adjustment schedule record by ID
List pay rate adjustment schedule
Update pay rate adjustment schedule record
Employee Qualifications
Summary
Add/Update Employee Qualification
Create Employee Qualification Document
Delete Employee Qualification
Delete Employee Qualification Document
Get Qualification Details
Get Qualification Document File
Get Qualification Document by ID
Get Qualifications for Employee
List Documents for Employee Qualification
Employee Reporting Dimension Earnings Line Split
Summary
Create Dimension Earnings Line Split
Delete Dimension Earnings Line Split
Get Employee Dimension Earnings Line Split By Id
Get Employee Dimension Earnings Line Splits
Update Dimension Earnings Line Split
Employee Self Setup
Summary
Accept Roster Shift
Accept Shift Swap
Acknowledge Document
Add Employee Qualification
Add Note to Shift
Bulk Accept Roster Shift Swaps
Bulk Accept Roster Shifts
Bulk Cancel Roster Shift Swaps
Bulk Decline Roster Shift Swaps
Bulk Decline Roster Shifts
Cancel Shift Swap
Clock In Employee
Clock Out Employee
Create Bank Account
Create Expense Request
Create Leave Request
Create Unavailability
Decline Roster Shift
Decline Shift Swap
Delete Attachment from Leave Request
Delete Bank Account
Delete Employee Profile Image
Delete Employee Qualification
Delete Expense Request
Delete Leave Request
Delete Timesheet
Delete Unavailability
Delete attachment from EmployeeQualification
Discard current shift
Download Document
Edit Timesheet
Employees Eligible For Shift Swap
End Break
Estimate Leave Hours
Find Matching Clock Off Roster Shift
Find Matching Clock On Roster Shift
Find Nearby Roster Shifts
Get Bank Account by ID
Get Dashboard
Get Details
Get Document Details by ID
Get Earnings Certificate PDF
Get Earnings Certificates
Get Emergency Contacts
Get Employee Profile Image
Get Employees
Get Enabled Features
Get Expense Categories
Get Expense Payment Summary
Get Expense Request by ID
Get Expense Requests
Get KiwiSaver Enrollment Options
Get KiwiSaver options for employee
Get Leave Balances
Get Leave Categories
Get Leave Request by ID
Get Locations
Get Lookup Data
Get Pay Slip by Pay Run ID
Get Personal Details
Get Qualification Details
Get Qualifications for Employee
Get Roster Shift by ID
Get Satisfaction Survey Results
Get Shift Conditions
Get Shift Notes
Get Suburb
Get Tax Codes
Get Timesheet Creation Data
Get Titles
Get Work Types
Get public holidays
Get unavailability by ID
List Bank Accounts
List Leave Requests
List Pay Slips
List Roster Shifts
List Timesheets
List Unavailabilities
List all Documents
Mark Shift Notes Read
Propose Shift Swap
Recover Forgotten Password
Register Device Token
Save Details
Save Emergency Contacts
Search Suburbs
Set Employee Profile Image
Shifts
Start Break
Submit Satisfaction Survey
Submit or Update Timesheet
Unregister Device Token
Update Bank Account
Update Emergency Contacts
Update Employee Qualification
Update Expense Request
Update Leave Request
Update Personal Details
Update Unavailability
Upload Attachment to Expense Request
Upload Attachment to Leave Request
Upload attachment to qualification
Employer Liability Categories
Summary
Create Employer Liability Category
Delete Employer Liability Category
Get Employer Liability Category
List Employer Liability Categories
Update Employer Liability Category
Employing Entities
Summary
Create Employing Entity
Delete Employing Entity
Get Employing Entity By ID
List Employing Entities
Update Employing Entity
Employment Agreement
Summary
Get Shift Costings for Employee
Get Shift Periods for Employee
Invoices
Summary
Get Brand Invoice By ID
Get Brand Invoice Excel By ID
Get Brand Invoice PDF By ID
Get Brand Invoices
Get Business Invoice By ID
Get Business Invoice PDF By ID
Get Business Invoices
Get Reseller Invoice By ID
Get Reseller Invoice Excel By ID
Get Reseller Invoice PDF By ID
Get Reseller Invoices
Get White Label Invoice By ID
Get White Label Invoice Excel By ID
Get White Label Invoice PDF By ID
Get White Label Invoices
Leave Allowances
Summary
Assign Leave Allowance Template
Create Leave Allowance Template
Delete Leave Allowance Template
Get Leave Allowance Template by ID
Get Leave Allowance Template for Employee
Get Leave Allowances for All Employees
Get Leave Allowances for Employee
List Leave Allowance Templates
Reapply Leave Allowance Template
Set Leave Allowances
Update Leave Allowance Template
Leave Categories
Summary
Create Leave Category
Delete Leave Category
Get Holiday Leave Settings
Get Leave Category by ID
List Leave Categories
Set Holiday Leave Settings
Update Leave Category
Leave Requests
Summary
Approve Leave Request
Create Leave Request
Decline Leave Request
Delete Leave Request
Estimate Leave Units
Get Leave Request by ID
Get Leave Requests for Employee
List Leave Requests
Update Leave Request
Update Leave Request
Location
Summary
Create Location
Delete Location
Get Location By Id
List Business Locations
List Employee Locations
Update Location
Lookup Data
Summary
List Employee Group Permission Types
List Report Types
List Time Zone Types
List Time Zone Types
List countries
List gender options
List industry options
Manager
Summary
Add Note to Shift
Add an Employee
Approve Expense Request
Approve Leave Request
Approve Timesheet
Change PIN
Check Employee
Clock In Employee
Clock Out Employee
Create Leave Request
Create Unavailability
Create expense request
Create kiosk timesheet line
Create roster shift
Create timesheet line
Decline Expense Request
Decline Leave Request
Delete Employee Profile Image
Delete Expense Request
Delete Leave Request
Delete Note from Shift
Delete Timesheet
Delete Unavailability
Discard current shift
Download Document
Edit Expense Request
Edit Timesheet
End Break
Estimate Leave Hours
Find Matching Clock Off Roster Shift
Find Matching Clock On Roster Shift
Find Nearby Roster Shifts
Get Business Expense Requests
Get Business Timesheets
Get Business Timesheets
Get Dashboard
Get Employee Lookup Data
Get Employee Profile Image
Get Kiosk by ID
Get Kiosks
Get Leave Balances
Get Leave Request Attachment
Get Leave Request by ID
Get List of Employees
Get List of Locations
Get Roster Shift by ID
Get Roster Shifts
Get Rounding Rules
Get Shift Notes
Get expense request
Get expenses reference data
Get the list of roles available
Get timesheet
Get timesheet reference data
Initiate Employee Self Setup
List Businesses
List Employee Groups
List Employee Locations
List Employee Locations
List Expense Categories
List Expense Request Employees
List Expense Request Locations
List Kiosk Staff
List Leave Categories
List Leave Categories
List Leave Employees
List Leave Locations
List Leave Requests
List Manager Roster Employees
List Roster Employees
List Roster Locations
List Tax Codes
List Timesheet Employees
List Timesheet Locations
Manage Roster Data
Mark Shift Notes Read
Overlapping Leave Requests
Overlapping Leave Requests
Reject Timesheet
Send PIN Reset Email
Send PIN Reset SMS
Set Employee Profile Image
Set Rounding Rules
Shifts
Start Break
Stub Shift Timesheets
Update Leave Request
Update Unavailability
Update comments in a timesheet
Update kiosk timesheet line
Update roster shift
Update timesheet line
Upload Attachment to Expense Request
Verify Kiosk PIN
Pay Category
Summary
Create Pay Category
Delete Pay Category
Get Pay Category by ID
List Pay Categories
Update Pay Category
Pay Rate Templates
Summary
Create Pay Rate Template
Delete Pay Rate Template
Get Pay Rate Template by ID
List Pay Rate Templates
Update Pay Rate Template
Pay Run
Summary
Bulk Apply Leave Requests
Create Deductions
Create Earnings Lines
Create Employee Expenses
Create Employer Liabilities
Create KiwiSaver Adjustments
Create Note for Employee
Create PAYE Adjustments
Create Pay Run
Create Pay Run (Async)
Delete Deduction
Delete Earnings Line
Delete Employee Expense
Delete Employer Liability
Delete KiwiSaver Adjustment
Delete Leave Accrual
Delete Note for Employee
Delete PAYE Adjustment
Delete Pay Run
Delete Pay Run Notation
Finalise Pay Run
Get Bank Payment File
Get Creation Status
Get Deductions by Employee ID
Get Earnings Lines by Employee ID
Get Employee Expenses by Employee ID
Get Employer Liabilities by Employee ID
Get Journal Details
Get KiwiSaver Adjustments by Employee ID
Get Leave Accruals
Get Leave Accruals for Employee
Get PAYE Adjustments by Employee ID
Get Pay Run
Get Pay Run Details
Get Pay Run Summary
Get Pay Run Totals by Employee ID
Get Pay Slip Data by Employee ID
Get Pay Slip File
Get pay run payments
Include Employee
List Deductions
List Earnings Lines
List Employee Expenses
List Employer Liabilities
List KiwiSaver Adjustments
List PAYE Adjustments
List Pay Run Totals
List Pay Run Totals for Employee
List Pay Run Warnings
List Pay Runs
List Pay Runs Summaries
List Pay Slip Data
Net to Gross
Recalculate
Remove Employee from Pay Run
Save Leave Accruals
Set Pay Run Notation
Set UI Unlock enabled
Start Approval Process
Start Payment Approval Process
Terminate Employee in Pay Run
Unlock Pay Run
Pay Run Inclusions
Summary
Create Employee Additional Earning
Create Employee Deduction
Create Employee Expense
Create Employee Tax Adjustment
Create Employer liability
Delete Employee Additional Earning
Delete Employee Deduction
Delete Employee Expense
Delete Employee Tax Adjustment
Delete Employer liability
Get Employee Additional Earning by ID
Get Employee Deduction by External Reference Id
Get Employee Deduction by ID
Get Employee Expense by ID
Get Employee Tax Adjustment by ID
Get Employer liability by ID
List Employee Additional Earnings
List Employee Deductions
List Employee Deductions By External Reference Id
List Employee Expenses
List Employee Tax Adjustments
List Employer liabilities
Update Employee Additional Earning
Update Employee Deduction
Update Employee Expense
Update Employee Tax Adjustment
Update Employer liability
Pay Schedules
Summary
Create Pay Schedule
Delete Pay Schedule
Get Next Pay Date
Get Pay Schedule Metadata
Get Pay Schedule by ID
List Next Pay Dates
List Pay Schedules
Update Pay Schedule
Public Holiday
Summary
Add a public holiday
Delete Public Holiday
Delete Public Holiday by Date
Get Public Holiday Details
Get Public Holidays for Year
Update Public Holiday
Qualifications
Summary
Create Qualification
Delete Qualification
Get Qualification by ID
List Qualifications
Update Qualification
Reporting
Summary
Birthday Report
Costing Report
Deductions Report
Deductions Report as Excel
Deprecated Detailed Activity Report as Excel
Deprecated Pay Run Audit Report
Deprecated Pay Run Variance Report
Detailed Activity Report
Detailed Activity Report as Excel
Document Acknowledgements Report
Employee Audit Report
Employee Details Report
Employee Details Report
Employee Details Report Fields
Employee Payment History Report
Employee Payment History Report as Excel
Get Pay Slips by Finalised Pay Run Id
Get shift swapping report by business id
Get tasks by business id
Gross To Net Report
Gross To Net Report as Excel
Journal Report
KiwiSaver Report
KiwiSaver Report as Excel
Leave Balances Report
Leave Balances Report as Excel
Leave Liability Report
Leave Liability report as Excel
Ordinary Time Earnings Report
PAYE Report
Pay Categories Report
Pay Run Audit Report
Pay Run Inclusions Report
Pay Run Variance Report
Prepare Leave Liability report
Roster vs Timesheet Comparison Report
Timesheet Report
Reseller
Summary
Get Reseller by ID
List Resellers
Roster Shifts
Summary
Create roster shift
Find Matching Clock Off Roster Shift
Find Matching Clock On Roster Shift
Find Nearby Roster Shifts
Get Roster Shifts
Stub Shift Timesheets
Update roster shift
Time and Attendance
Summary
Add Complete Shift for Employee
Add Note to Shift
Add an Employee
Change PIN
Check Employee
Clock In Employee
Clock Out Employee
Create Kiosk
Delete Kiosk
Delete Note from Shift
Discard current shift
Employee Has Access
End Break
Get Employee Lookup Data
Get Kiosk by ID
Get Shift Notes
List Kiosk Staff
List Kiosks
Mark Shift Notes Read
Send PIN Reset Email
Send PIN Reset SMS
Shifts
Start Break
Update Kiosk
Verify Kiosk PIN
Timesheets
Summary
Bulk Insert Timesheets
Create timesheet line
Delete timesheet line
Get Business Timesheets
Update timesheet line
Update/Replace timesheets
Unavailability
Summary
Create Unavailability
Delete Unavailability
Get unavailability by ID
List Unavailabilities
Update Unavailability
User
Summary
Create New User
Get User Details
Update User
Webhook
Summary
Delete Web Hook Registration
Delete all Web Hook Registrations
Get Web Hook Registration by ID
List Web Hook Registrations
Register Web Hook
Test Web Hook
Update Web Hook Registration
White Label
Summary
Active Employees Report
Get White Label by ID
List White Labels
Signup Report
Work Types
Summary
Create Work Type
Delete Work Type
Get Work Type by ID
List Work Types
Update Work Type
OpenAPI specification
Download
IHttpActionResult resource
Methods
put
- Upload Attachment to Expense Request
put
- Upload Attachment to Leave Request
put
- Upload attachment to qualification
put
- Upload Attachment to Expense Request
Resource
{}
Properties
Name
Type
Description