Skip to main content
Server path: /ukg-payroll | Type: Application | PCID required: Yes

Tools

ToolDescription
ukg-payroll_add_accrualsImport Accruals Information
ukg-payroll_company_pay_detail_get_pay_statement_reports_v2Retrieve finalized pay history details from UKG Pro. This includes earnings, deductions, and tax data.
ukg-payroll_create_deduction_pending_pay_itemCreate Deduction Pending Pay Item
ukg-payroll_create_earnings_pending_pay_itemCreate Earnings Pending Pay Item
ukg-payroll_deductions_history_getGet Payroll Deductions History
ukg-payroll_delete_accrual_by_batch_idDelete Accrual by Batch ID
ukg-payroll_delete_accrual_by_batch_id_and_source_idDelete Accrual by Batch ID and Source ID
ukg-payroll_delete_deduction_pending_pay_itemDelete Deduction Pending Pay Item
ukg-payroll_delete_earnings_pending_pay_itemDelete Earnings Pending Pay Item
ukg-payroll_delete_services_payroll_v1_import_pay_items_earnings_ref_idDelete Earning by ID
ukg-payroll_earnings_history_get_ins_rateGet Earnings History Base Elements
ukg-payroll_general_ledger_run_details_v2_getRetrieve General Ledger Runs
ukg-payroll_general_ledger_run_details_v2_get_by_run_idRetrieve General Ledger Run by ID
ukg-payroll_get_activitiesObtains all activities.
ukg-payroll_get_assigned_holidaysObtains all assigned holidays.
ukg-payroll_get_clock_pending_transactionsGet pending clock transactions.
ukg-payroll_get_clock_transactionsGet processed clock transactions.
ukg-payroll_get_current_userObtains the current user information.
ukg-payroll_get_employee_jobsObtains all jobs for an employee.
ukg-payroll_get_employeesObtains all employees.
ukg-payroll_get_hour_typesObtains all hour types.
ukg-payroll_get_services_payroll_v1_import_pay_items_earnings_ref_idRetrieve Earning by ID
ukg-payroll_get_services_ws_mob_simpleschedule_coid_employees_eeidObtains a UTA Employee by coId and eeId.
ukg-payroll_get_teamsObtains all teams.
ukg-payroll_get_time_codesObtains all time codes.
ukg-payroll_get_time_off_requestsObtains all time off requests.
ukg-payroll_get_v1_companies_company_id_direct_depositGet list of direct deposit details for US and Canadian employees by company
ukg-payroll_get_v1_direct_depositGet list of direct deposit details for US and Canadian employees
ukg-payroll_get_v1_employees_pay_statement_pay_identifierGet employee pay statement based on the given pay identifier.
ukg-payroll_get_work_summariesObtain work summaries.
ukg-payroll_get_work_summaryObtain a work summary.
ukg-payroll_pay_group_pay_period_get_pay_group_pay_periodGet PayGroup PayPeriods
ukg-payroll_pay_register_getGet Pay Register
ukg-payroll_post_services_payroll_v1_import_pay_items_earningsImport Earnings for Payroll
ukg-payroll_post_v1_companies_pay_statementsGet employee(s) pay statement(s) for a company or pay group for a given date range.
ukg-payroll_post_v1_companies_pay_statements_summaryGet employee(s) pay statement(s) summary for a company or pay group for a given date range.
ukg-payroll_post_v1_employees_pay_statement_lastGet employee last pay statement based on the passed employee identifier.
ukg-payroll_post_v1_employees_pay_statementsGet employee pay statement(s) based on the passed employee identifier for a given date range.
ukg-payroll_put_schedule_detailsPublish schedule details.
ukg-payroll_retrieve_deduction_pending_pay_item_by_idRetrieve Deduction Pending Pay Item by ID
ukg-payroll_retrieve_deduction_pending_pay_item_by_source_keyRetrieve Deduction Pending Pay Item by Source Key
ukg-payroll_retrieve_earnings_pending_pay_item_by_idRetrieve Earnings Pending Pay Item by ID
ukg-payroll_retrieve_earnings_pending_pay_item_by_source_keyRetrieve Earnings Pending Pay Item by Source Key
ukg-payroll_retrieve_employee_pay_details_report_v1Retrieve finalized pay history details from UKG Pro (v1). This includes earnings, deductions, and tax data.

ukg-payroll_add_accruals

Import Accruals Information Parameters:
ParameterTypeRequiredDefaultDescription
US-Client-IdstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
User-AgentstringYesPopulates the SourceSytem table into the PayrollPendingItemAccruals table during the import process.
bodyobject[]YesRequest body

ukg-payroll_company_pay_detail_get_pay_statement_reports_v2

Retrieve finalized pay history details from UKG Pro. This includes earnings, deductions, and tax data. Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringNoCompany identifier the component company of the pay statements
endDatestringYesEnding date for the pay period range to retrieve (inclusive)
pageintegerNoThe page number for pagination, starting at 1.
pagesCountintegerNoThe number of pages.
payGroupstringNoIdentifier for a specific group of employees with the same pay schedule
payPeriodIdintegerNoUnique identifier for a specific pay period
per_PageintegerNoNumber of records to return per page (1-200)
startDatestringYesBeginning date for the pay period range to retrieve (inclusive)

ukg-payroll_create_deduction_pending_pay_item

Create Deduction Pending Pay Item Parameters:
ParameterTypeRequiredDefaultDescription
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
commentsstringNoA set of notes about the earnings that you may want or need to include.
companyCodestringYesThe company identifier: company code.
deductionAmountEEstringNoThe employee deduction amount. Format must be: nnn.nn.
deductionAmountERstringNoThe employer deduction amount. Format must be: nnn.nn.
deductionCodestringYesThe deduction code, which must be a deduction with calculation rule Flat Amount and assigned to the employee or part of the employee’s deduction group.
employeeNumberstringYesThe employee identifier: employee number.
includeInNextPayDatebooleanNoA Boolean indicator of whether or not the item is to be paid in the next payroll. If a Scheduled pay date is not provided, it will default to be included in the next payroll.
itemStatusstringNoThe pending pay item status. Only statuses of ‘Pending’ or ‘Submitted’ are allowed.
itemTypestringYesThe item type of the pending pay record. The system delivered items types available to use are: ‘OnDemandPay’, ‘Giving’, ‘BenefitsInt’, ‘DeductionImport’, ‘Standard’, ‘RetroPay’, ‘StandardAPI’ and ‘EarningImport’. If it is not sent, it will default to ‘StandardAPI’. If sent and an the item type does not exist, it will automatically create a custom item type.
scheduledPayDatestringYesThe pay date that the earning is to be paid, which is the Scheduled Pay Date for all imported earnings is Next Pay Date unless a pay date is sent. It does not need to be sent if includeInNextPayDate is true. It must be provided if includeInNextPayDate is false. If provided, it must be a pay date for a regular payroll for the employee’s pay group. If it is not a regular payroll pay date, the earning will not be paid. Format is YYYY-MM-DD.
sourceKeystringNoA uniquely identifying, user generated source key that is sent in a POST. Pass this as a query parameter in a GET to identify the record you want.
userNamestringYesThe username of the employee updating the pending pay record. If not specified, ‘Pending Pay Items API’ is used.

ukg-payroll_create_earnings_pending_pay_item

Create Earnings Pending Pay Item Parameters:
ParameterTypeRequiredDefaultDescription
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
commentsstringNoA set of notes about the earnings that you may want or need to include.
companyCodestringYesThe company identifier: company code.
earnAmountstringNoThe earning amount. Format should be: nnn.nn.
earnCodestringYesThe earning code, which must be an earning with a Flat Amount, Flat Amount Track Hours or some related hours based (that is, hours x rate x rate factor) calculation rule.
earnHoursstringNoEarning hours. Format should be: nnn.nn.
employeeNumberstringYesThe employee identifier: employee number.
includeInNextPayDatebooleanNoA Boolean indicator of whether or not the item is to be paid in the next payroll. If a Scheduled pay date is not provided, it will default to be included in the next payroll.
itemStatusstringNoThe pending pay item status. Only statuses of ‘Pending’ or ‘Submitted’ are allowed.
itemTypestringYesThe item type of the pending pay record. The system delivered items types available to use are: ‘OnDemandPay’, ‘Giving’, ‘BenefitsInt’, ‘DeductionImport’, ‘Standard’, ‘RetroPay’, ‘StandardAPI’ and ‘EarningImport’. If it is not sent, it will default to ‘StandardAPI’. If sent and an the item type does not exist, it will automatically create a custom item type.
scheduledPayDatestringYesThe pay date that the earning is to be taken. The Scheduled Pay Date for all imported earnings is Next Pay Date unless a pay date is sent. It does not need to be sent if includeInNextPayDate is true. It must be provided if includeInNextPayDate is false. If provided, it must be a pay date for a regular payroll for the employee’s pay group. If it is not a regular payroll pay date, the earning will not be taken. Format is YYYY-MM-DD.
sourceKeystringNoA uniquely identifying, user generated source key that is sent in a POST. Pass this as a query parameter in a GET to identify the record you want.
userNamestringYesThe username of the employee updating the pending pay record. If not provided, ‘Pending Pay Items API’ will be used.

ukg-payroll_deductions_history_get

Get Payroll Deductions History Parameters:
ParameterTypeRequiredDefaultDescription
employeeIdstringNoEmployee Id
companyIdstringNoCompany Id
checkIdstringNoCheck Id
employeeNumberstringNoEmployee Number
deductionCodestringNoDeduction Code
deductionTypestringNoDeduction Type
benefitOptionstringNoBenefit Option
benefitProviderstringNoBenefit Provider
payGroupstringNoPay Group
periodControlstringNoPeriod Control
payDatestringNoPay Date
is401KstringNoIs401 K
is403BstringNoIs403 B
is408KstringNoIs408 K
is408PstringNoIs408 P
is457stringNoThe is457 value
is457BstringNoIs457 B
is457FstringNoIs457 F
is501CstringNoIs501 C
isD125stringNoIs D125
isDeductionOffSetstringNoIs Deduction Off Set
isDeferredCompensationstringNoIs Deferred Compensation
isDependentCarestringNoIs Dependent Care
isHousingstringNoIs Housing
isNonQualifiedPlanstringNoIs Non Qualified Plan
startPerControlstringNoStart Per Control
endPerControlstringNoEnd Per Control
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_delete_accrual_by_batch_id

Delete Accrual by Batch ID Parameters:
ParameterTypeRequiredDefaultDescription
US-Client-IdstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
User-AgentstringYesPopulates the SourceSytem table into the PayrollPendingItemAccruals table during the import process.
batchIdstringYesIdentifier for a batch of accruals.

ukg-payroll_delete_accrual_by_batch_id_and_source_id

Delete Accrual by Batch ID and Source ID Parameters:
ParameterTypeRequiredDefaultDescription
US-Client-IdstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
User-AgentstringYesPopulates the SourceSytem table into the PayrollPendingItemAccruals table during the import process.
batchIdstringYesA unique identifier for a batch of accruals.
sourceIdstringYesA unique identifier for accrual from source system.

ukg-payroll_delete_deduction_pending_pay_item

Delete Deduction Pending Pay Item Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe Pending Pay Item ID.
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.

ukg-payroll_delete_earnings_pending_pay_item

Delete Earnings Pending Pay Item Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe Pending Pay Item ID.
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.

ukg-payroll_delete_services_payroll_v1_import_pay_items_earnings_ref_id

Delete Earning by ID Parameters:
ParameterTypeRequiredDefaultDescription
x-correlation-idstringNoA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
refIdstringYesA unique identifier associated with an earning.

ukg-payroll_earnings_history_get_ins_rate

Get Earnings History Base Elements Parameters:
ParameterTypeRequiredDefaultDescription
companyIDstringNoCompany ID
earningCodestringNoEarning Code
employeeIDstringNoEmployee ID
employeeNumberstringNoEmployee Number
payDatestringNoPay Date
payGroupstringNoPay Group
periodControlstringNoPeriod Control
startPerControlstringNoStart Per Control
endPerControlstringNoEnd Per Control
includeInDeferredCompensationbooleanNoInclude In Deferred Compensation
includeInDeferredCompensationHoursbooleanNoInclude In Deferred Compensation Hours
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_general_ledger_run_details_v2_get

Retrieve General Ledger Runs Parameters:
ParameterTypeRequiredDefaultDescription
runIdstringNoRun Id
blockIdstringNoBlock Id
mostRecentstringNoMost Recent
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_general_ledger_run_details_v2_get_by_run_id

Retrieve General Ledger Run by ID Parameters:
ParameterTypeRequiredDefaultDescription
runIdstringYesRun Id
blockIdstringNoBlock Id
mostRecentstringNoMost Recent
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_get_activities

Obtains all activities. Parameters:
ParameterTypeRequiredDefaultDescription
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_assigned_holidays

Obtains all assigned holidays. Parameters:
ParameterTypeRequiredDefaultDescription
emp_namestringNoEmp Name
emp_idintegerNoEmp Id
fromstringYesStart range for holidays
tostringYesEnd range for holidays
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_clock_pending_transactions

Get pending clock transactions. Parameters:
ParameterTypeRequiredDefaultDescription
emp_namestringNoEmployee can be specified by their emp_name or emp_id. At least one parameter must be specified.
emp_idintegerNoEmployee can be specified by their emp_name or emp_id. At least one parameter must be specified.
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_clock_transactions

Get processed clock transactions. Parameters:
ParameterTypeRequiredDefaultDescription
emp_namestringNoEmployee can be specified by their emp_name or emp_id. At least one parameter must be specified.
emp_idintegerNoEmployee can be specified by their emp_name or emp_id. At least one parameter must be specified.
datestringYesDate of clock transaction
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_current_user

Obtains the current user information. Parameters:
ParameterTypeRequiredDefaultDescription
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_employee_jobs

Obtains all jobs for an employee. Parameters:
ParameterTypeRequiredDefaultDescription
emp_namestringNoEmp Name
emp_idintegerNoEmp Id
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_employees

Obtains all employees. Parameters:
ParameterTypeRequiredDefaultDescription
indexintegerNoIndex when paging is to be used.
maxintegerNoMax elements per page
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_hour_types

Obtains all hour types. Parameters:
ParameterTypeRequiredDefaultDescription
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_services_payroll_v1_import_pay_items_earnings_ref_id

Retrieve Earning by ID Parameters:
ParameterTypeRequiredDefaultDescription
x-correlation-idstringNoA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
refIdstringYesA unique identifier associated with an earning.

ukg-payroll_get_services_ws_mob_simpleschedule_coid_employees_eeid

Obtains a UTA Employee by coId and eeId. Parameters:
ParameterTypeRequiredDefaultDescription
coidstringYescoid of employee.
eeidstringYeseeid of employee.
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_teams

Obtains all teams. Parameters:
ParameterTypeRequiredDefaultDescription
indexintegerNoIndex when paging is to be used.
maxintegerNoMax elements per page
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_time_codes

Obtains all time codes. Parameters:
ParameterTypeRequiredDefaultDescription
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_time_off_requests

Obtains all time off requests. Parameters:
ParameterTypeRequiredDefaultDescription
emp_namestringNoEmp Name
emp_idintegerNoEmp Id
fromstringYesStart range for requests
tostringYesEnd range for requests
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_v1_companies_company_id_direct_deposit

Get list of direct deposit details for US and Canadian employees by company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
accountIsInactivestringNoAccount Is Inactive
employeeIdstringNoEmployee Id
employeeBankRoutingNumberstringNoEmployee Bank Routing Number
countryCodestringNoCountry Code
dateTimeChangedstringNoUsed to find direct deposit record changed date less than, greater than, equal to, or between passed date(s)
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_get_v1_direct_deposit

Get list of direct deposit details for US and Canadian employees Parameters:
ParameterTypeRequiredDefaultDescription
accountIsInactivestringNoAccount Is Inactive
employeeIdstringNoEmployee Id
companyIdstringNoCompany Id
employeeBankRoutingNumberstringNoEmployee Bank Routing Number
countryCodestringNoCountry Code
dateTimeChangedstringNoUsed to find direct deposit record changed date less than, greater than, equal to, or between passed date(s)
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_get_v1_employees_pay_statement_pay_identifier

Get employee pay statement based on the given pay identifier. Parameters:
ParameterTypeRequiredDefaultDescription
PayIdentifierstringYesPay Identifier
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.

ukg-payroll_get_work_summaries

Obtain work summaries. Parameters:
ParameterTypeRequiredDefaultDescription
emp_namestringNoEmployee can be specified by their emp_name or emp_id. At least one parameter must be specified.
emp_idintegerNoEmployee can be specified by their emp_name or emp_id. At least one parameter must be specified.
fromstringYesStart range for work summaries
tostringYesEnd range for work summaries
fullbooleanNoSpecifies if both clock and work detail data should be loaded
authStatusbooleanNoIf specified will load only work summaries with Authorized status equal to true or false
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_get_work_summary

Obtain a work summary. Parameters:
ParameterTypeRequiredDefaultDescription
workSummaryIdintegerYesWork Summary id
wbatstringYesThe wbat header required for authorization in subsequent requests.

ukg-payroll_pay_group_pay_period_get_pay_group_pay_period

Get PayGroup PayPeriods Parameters:
ParameterTypeRequiredDefaultDescription
payDateSeqintegerNoPay Date Seq
periodEndDatestringNoPeriod End Date
periodStartDatestringNoPeriod Start Date
payGroupstringNoPay Group
payDatestringNoPay Date
startPerControlstringNoStart Per Control
endPerControlstringNoEnd Per Control
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_pay_register_get

Get Pay Register Parameters:
ParameterTypeRequiredDefaultDescription
employeeIdstringNoEmployee Id
companyIdstringNoCompany Id
checkIdstringNoCheck Id
employeeNumberstringNoEmployee Number
documentNumberstringNoDocument Number
payGroupstringNoPay Group
periodControlstringNoPeriod Control
payDatestringNoPay Date
periodEndDatestringNoPeriod End Date
periodStartDatestringNoPeriod Start Date
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-payroll_post_services_payroll_v1_import_pay_items_earnings

Import Earnings for Payroll Parameters:
ParameterTypeRequiredDefaultDescription
x-correlation-idstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
failAllOnRequestbooleanNoA Boolean indicator of whether or not the entire request fails if any errors are present. When false, valid earnings are staged for import even when errors are present in the request payload.
earningsobject[]NoThe earnings value

ukg-payroll_post_v1_companies_pay_statements

Get employee(s) pay statement(s) for a company or pay group for a given date range. Parameters:
ParameterTypeRequiredDefaultDescription
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
companyIdstringNoCompany Id
endDatestringYesEnd date for filtering
pageintegerNoPage number for pagination
pagesCountintegerNoPages Count
payGroupstringNoPay Group
per_PageintegerNoNumber of results per page
startDatestringYesStart date for filtering

ukg-payroll_post_v1_companies_pay_statements_summary

Get employee(s) pay statement(s) summary for a company or pay group for a given date range. Parameters:
ParameterTypeRequiredDefaultDescription
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
companyIdstringNoCompany Id
endDatestringYesEnd date for filtering
pageintegerNoPage number for pagination
pagesCountintegerNoPages Count
payGroupstringNoPay Group
per_PageintegerNoNumber of results per page
startDatestringYesStart date for filtering

ukg-payroll_post_v1_employees_pay_statement_last

Get employee last pay statement based on the passed employee identifier. Parameters:
ParameterTypeRequiredDefaultDescription
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
employeeIdentifierobjectNoEmployee Identifier
endDatestringNoEnd date for filtering
pageintegerNoPage number for pagination
pagesCountintegerNoPages Count
per_PageintegerNoNumber of results per page
startDatestringNoStart date for filtering

ukg-payroll_post_v1_employees_pay_statements

Get employee pay statement(s) based on the passed employee identifier for a given date range. Parameters:
ParameterTypeRequiredDefaultDescription
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
employeeIdentifierobjectNoEmployee Identifier
endDatestringNoEnd date for filtering
pageintegerNoPage number for pagination
pagesCountintegerNoPages Count
per_PageintegerNoNumber of results per page
startDatestringNoStart date for filtering

ukg-payroll_put_schedule_details

Publish schedule details. Parameters:
ParameterTypeRequiredDefaultDescription
wbatstringYesThe wbat header required for authorization in subsequent requests.
commentstringNoThe comment value
scheduleDetailsobject[]NoSchedule Details

ukg-payroll_retrieve_deduction_pending_pay_item_by_id

Retrieve Deduction Pending Pay Item by ID Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe Pending Pay Item ID.
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.

ukg-payroll_retrieve_deduction_pending_pay_item_by_source_key

Retrieve Deduction Pending Pay Item by Source Key Parameters:
ParameterTypeRequiredDefaultDescription
sourcekeystringYesThe source key.
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.

ukg-payroll_retrieve_earnings_pending_pay_item_by_id

Retrieve Earnings Pending Pay Item by ID Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe Pending Pay Item ID.
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.

ukg-payroll_retrieve_earnings_pending_pay_item_by_source_key

Retrieve Earnings Pending Pay Item by Source Key Parameters:
ParameterTypeRequiredDefaultDescription
X-Correlation-IdstringYesA client-supplied GUID used for tracking the operation’s execution.
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
sourcekeystringYesThe source key.

ukg-payroll_retrieve_employee_pay_details_report_v1

Retrieve finalized pay history details from UKG Pro (v1). This includes earnings, deductions, and tax data. Parameters:
ParameterTypeRequiredDefaultDescription
us-client-idstringYesThe Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code.
accrualsobject[]NoThe accruals value
addressline1stringNoEmployee address line 1.
addressline2stringNoEmployee address line 2.
citystringNoEmployee city.
companyaddresscitystringNoComponent company city.
companyaddresscountrystringNoComponent company country.
companyaddresscountystringNoComponent company county.
companyaddressline1stringNoComponent company address line 1.
companyaddressline2stringNoComponent company address line 2.
companyaddresspostalcodestringNoComponent company postal code.
companyaddressstateorprovincestringNoComponent company state or province
companynamestringNoComponent company name.
companyphonestringNoComponent company phone number.
companyphoneextstringNoComponent company phone extention.
countrystringNoThe country value
deductionsobject[]NoThe deductions value
deductionscurrentnumberNoTotal deductions in current pay statement.
documentstringNoThe document value
earningsobject[]NoThe earnings value
employeeidentifierobjectNoThe employeeidentifier value
employeenumberstringNoEmployee number.
employeeStatusnumberNoEmployee status code. “A” = Active, “L” = Leave of Absence (LOA) “O” = On Strike “R” Released/Laid Off “S” = Suspended “T” = Terminated
federaladditionalamountWithheldnumberNoThe amount of money an employee requests to their employer to withhold from your paycheck to pay the Internal Revenue Service (IRS) for federal income taxes beyond the normal amount.
federalallowancesclaimedintegerNoThe number of federal allowances claimed.
fullnamestringNoThe employee’s full name.
grosswagescurrentnumberNoThe total wages on current pay statement.
jobstringNoThe employee’s job.
locationstringNoThe employee’s work location.
netpayobject[]NoThe netpay value
netpaycurrentnumberNoThe netpaycurrent value
orglevel1stringNoCustomer configured org level 1.
orglevel2stringNoCustomer configured org level 2.
orglevel3stringNoCustomer configured org level 3.
orglevel4stringNoCustomer configured org level 4.
paydatestringNoThe pay date for the pay statement.
paygroupstringNoPay group code for the pay statement.
payidentifierstringNoGenNumber for the pay statement.
payperiodfrequencystringNoPay frequency (for example: monthly, weekly, bi-weekly, etc.).
payratenumberNoPay rate for the employee.
periodenddatestringNoEnd date for the pay period.
periodstartdatestringNoStart date for the pay period.
postalcodestringNoThe postalcode value
residentstateallowancesclaimedintegerNoThe number of state allowances claimed.
ssnstringNoThe employee’s social security number.
stateorprovincestringNoState or Province
taxesobject[]NoThe taxes value
taxescurrentnumberNoTotal taxes in current pay statement.
workstateallowancesclaimedintegerNoThe workstateallowancesclaimed value