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

Tools

ToolDescription
ukg-employee-admin_dependent_deductions_getGet Dependent Deductions
ukg-employee-admin_emp_ded_ben_option_date_getGet Employee Deduction Benefit Option Change Date
ukg-employee-admin_get_personnel_v1_audit_detailsGet Audit Details Data
ukg-employee-admin_get_personnel_v1_companies_company_id_compensation_detailsGet all compensation details by company
ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_compensation_detailsGet all compensation details by company and employee
ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_employment_detailsRetrieve Employment Details by Employee ID and Company
ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_person_detailsGet a single person detail record for a single company
ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_pto_plansGet a specific employees pto-plans
ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_pto_plans_pto_planGet a specific pto-plan
ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_user_defined_fieldsGet User Defined Fields for a single employee in a single company
ukg-employee-admin_get_personnel_v1_companies_company_id_employment_detailsRetrieve Employment Details by Company ID
ukg-employee-admin_get_personnel_v1_companies_company_id_person_detailsGet all person details for a single company
ukg-employee-admin_get_personnel_v1_companies_company_id_user_defined_fieldsGet User Defined Fields for single company
ukg-employee-admin_get_personnel_v1_deduction_history_effective_change_datesDeductions History Effective Change Date
ukg-employee-admin_get_personnel_v1_emp_deductionsGet employee deductions
ukg-employee-admin_get_personnel_v1_integration_audit_configurationGet Integration Audit Configuration Data
ukg-employee-admin_get_personnel_v1_integration_kronos_business_structure_statusGets a list of Employees for which there is a change in business structure
ukg-employee-admin_get_personnel_v1_integration_kronos_employee_profilesGet list of employees profile
ukg-employee-admin_get_personnel_v1_open_enrollment_dep_deductionsGet Open Enrollment Dependent Deductions Data
ukg-employee-admin_get_personnel_v1_pto_plansGet all pto-plans
ukg-employee-admin_get_personnel_v1_user_defined_fieldsGet User Defined Fields
ukg-employee-admin_get_personnel_v1_user_preferencesGet User Preferences Details
ukg-employee-admin_import_tool_get_file_statusFetches the status of the file.
ukg-employee-admin_import_tool_get_file_summaryFetches a summary of the file.
ukg-employee-admin_import_tool_get_statusRetrieves the status of an import tool transaction
ukg-employee-admin_import_tool_get_transaction_statusFetches the transaction name and status.
ukg-employee-admin_import_tool_imports_xml_dataTakes an XML transaction and feeds it into the Import Tool
ukg-employee-admin_import_tool_postTakes an XML transaction and feeds it into the Import Tool
ukg-employee-admin_kronos_employee_status_getGet Employee Status
ukg-employee-admin_open_enrollment_employee_deductions_get_audit_detailsGet Open Enrollment Employee Deductions
ukg-employee-admin_patch_personnel_v1_companies_company_id_employees_employee_id_pto_plans_pto_planPatch one PTO Plan
ukg-employee-admin_pay_deduction_element_getGet Global Employee Payments and Deductions Service
ukg-employee-admin_pc_fields_data_get_fields_dataPlatform Configuration Fields Data v1
ukg-employee-admin_pcfields_data_v2_get_fields_dataPlatform Configuration Fields Data v2
ukg-employee-admin_post_personnel_v1_pto_plansCreate A PTO Plan

ukg-employee-admin_dependent_deductions_get

Get Dependent Deductions Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringNoCompany Id
contactIdstringNoContact Id
deductionCodestringNoDeduction Code
employeeIdstringNoEmployee Id
effectiveDatestringNoEffective Date
currentCOIDstringNoCurrent COID
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_emp_ded_ben_option_date_get

Get Employee Deduction Benefit Option Change Date Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringNoCompany Id
deductionCodestringNoDeduction Code
effectiveDatestringNoEffective Date
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_audit_details

Get Audit Details Data Parameters:
ParameterTypeRequiredDefaultDescription
startDateTimestringYesStart Date Time
endDateTimestringYesEnd Date Time
tableNamestringYesTable Name
fieldNamestringYesField Name
actionstringNoThe action value
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_compensation_details

Get all compensation details by company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringNoEmployee Id
primaryJobCodestringNoPrimary Job Code
jobGroupCodestringNoJob Group Code
jobTitlestringNoJob Title
payGroupCodestringNoPay Group Code
fullTimeOrPartTimeCodestringNoFull Time Or Part Time Code
salaryOrHourlyCodestringNoSalary Or Hourly Code
primaryShiftCodestringNoPrimary Shift Code
primaryShiftGroupCodestringNoPrimary Shift Group Code
dateInJobstringNoUsed to find date in job less than, greater than, equal to, or between passed date(s)
dateLastPaidstringNoUsed to find date last paid less than, greater than, equal to, or between passed date(s)
datePaidThrustringNoUsed to find date paid through less than, greater than, equal to, or between passed date(s)
isAutoAllocatedstringNoIs Auto Allocated
isAutoPaidstringNoIs Auto Paid
isSeasonalWorkerstringNoIs Seasonal Worker
isHighlyCompensatedstringNoIs Highly Compensated
isMultipleJobstringNoIs Multiple Job
performanceReviewRatingstringNoPerformance Review Rating
performanceReviewTypestringNoPerformance Review Type
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_compensation_details

Get all compensation details by company and employee Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringYesEmployee Id
primaryJobCodestringNoPrimary Job Code
jobGroupCodestringNoJob Group Code
jobTitlestringNoJob Title
payGroupCodestringNoPay Group Code
fullTimeOrPartTimeCodestringNoFull Time Or Part Time Code
salaryOrHourlyCodestringNoSalary Or Hourly Code
primaryShiftCodestringNoPrimary Shift Code
primaryShiftGroupCodestringNoPrimary Shift Group Code
dateInJobstringNoUsed to find date in job less than, greater than, equal to, or between passed date(s)
dateLastPaidstringNoUsed to find date last paid less than, greater than, equal to, or between passed date(s)
datePaidThrustringNoUsed to find date paid through less than, greater than, equal to, or between passed date(s)
isAutoAllocatedstringNoIs Auto Allocated
isAutoPaidstringNoIs Auto Paid
isSeasonalWorkerstringNoIs Seasonal Worker
isHighlyCompensatedstringNoIs Highly Compensated
isMultipleJobstringNoIs Multiple Job
performanceReviewRatingstringNoPerformance Review Rating
performanceReviewTypestringNoPerformance Review Type
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_employment_details

Retrieve Employment Details by Employee ID and Company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringYesEmployee Id
primaryJobCodestringNoPrimary Job Code
jobTitlestringNoJob Title
fullTimeOrPartTimeCodestringNoFull Time Or Part Time Code
primaryWorkLocationCodestringNoPrimary Work Location Code
primaryProjectCodestringNoPrimary Project Code
deductionGroupCodestringNoDeduction Group Code
earningGroupCodestringNoEarning Group Code
employeeTypeCodestringNoEmployee Type Code
employeeStatusCodestringNoEmployee Status Code
employeeNumberstringNoEmployee Number
supervisorIDstringNoSupervisor ID
originalHireDatestringNoOriginal Hire Date
lastHireDatestringNoLast Hire Date
dateOfTerminationstringNoDate Of Termination
dateOfRetirementstringNoDate Of Retirement
dateTimeCreatedstringNoDate Time Created
dateTimeChangedstringNoDate Time Changed
dateLastPayDatePaidstringNoDate Last Pay Date Paid
payGroupstringNoPay Group
isHomeCompanybooleanNoIs Home Company
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_person_details

Get a single person detail record for a single company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringYesEmployee Id
lastNamestringNoLast Name
emailAddressstringNoEmail Address
addressStatestringNoAddress State
addressCountrystringNoAddress Country
cobraIsActivestringNoCobra Is Active
cobraStatusstringNoCobra Status
dateOfCobraEventstringNoUsed to find date of COBRA event less than, greater than, equal to, or between passed date(s)
dateTimeCreatedstringNoUsed to find person record created less than, greater than, equal to, or between passed date(s)
dateTimeChangedstringNoUsed to find person record changed less than, greater than, equal to, or between passed date(s)
nationalIdstringNoNational Id
nationalIdCountrystringNoNational Id Country
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_pto_plans

Get a specific employees pto-plans Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Identifier
employeeIdstringYesEmployee Identifier
pagenumberNoPagination, which page you want to see
per_pagenumberNoPagination, how many records per page you want to see

ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_pto_plans_pto_plan

Get a specific pto-plan Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Identifier
employeeIdstringYesEmployee Identifier
ptoPlanstringYesPTO Plan Identifier

ukg-employee-admin_get_personnel_v1_companies_company_id_employees_employee_id_user_defined_fields

Get User Defined Fields for a single employee in a single company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringYesEmployee Id
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_employment_details

Retrieve Employment Details by Company ID Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringNoEmployee Id
primaryJobCodestringNoPrimary Job Code
jobTitlestringNoJob Title
fullTimeOrPartTimeCodestringNoFull Time Or Part Time Code
primaryWorkLocationCodestringNoPrimary Work Location Code
primaryProjectCodestringNoPrimary Project Code
deductionGroupCodestringNoDeduction Group Code
earningGroupCodestringNoEarning Group Code
employeeTypeCodestringNoEmployee Type Code
employeeStatusCodestringNoEmployee Status Code
employeeNumberstringNoEmployee Number
supervisorIDstringNoSupervisor ID
originalHireDatestringNoOriginal Hire Date
lastHireDatestringNoLast Hire Date
dateOfTerminationstringNoDate Of Termination
dateOfRetirementstringNoDate Of Retirement
dateTimeCreatedstringNoDate Time Created
dateTimeChangedstringNoDate Time Changed
dateLastPayDatePaidstringNoDate Last Pay Date Paid
payGroupstringNoPay Group
isHomeCompanybooleanNoIs Home Company
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_person_details

Get all person details for a single company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringNoEmployee Id
lastNamestringNoLast Name
emailAddressstringNoEmail Address
addressStatestringNoAddress State
addressCountrystringNoAddress Country
cobraIsActivestringNoCobra Is Active
cobraStatusstringNoCobra Status
dateOfCobraEventstringNoUsed to find date of COBRA event less than, greater than, equal to, or between passed date(s)
dateTimeCreatedstringNoUsed to find person record created less than, greater than, equal to, or between passed date(s)
dateTimeChangedstringNoUsed to find person record changed less than, greater than, equal to, or between passed date(s)
nationalIdstringNoNational Id
nationalIdCountrystringNoNational Id Country
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_companies_company_id_user_defined_fields

Get User Defined Fields for single company Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Id
employeeIdstringNoEmployee Id
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_deduction_history_effective_change_dates

Deductions History Effective Change Date Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringNoCompany Id
sessionDatestringNoSession Date
fieldNamestringYesField Name
deductionCodestringYesDeduction Code
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_emp_deductions

Get employee deductions Parameters:
ParameterTypeRequiredDefaultDescription
employeeIdstringNoEmployee Id
companyIdstringNoCompany Id
dedCodestringYesDed Code
benStatusstringNoBen Status
benefitOptionstringNoBenefit Option
endDateTimestringNoEnd Date Time
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_integration_audit_configuration

Get Integration Audit Configuration Data Parameters:
ParameterTypeRequiredDefaultDescription
tableNamestringNoTable Name
fieldNamestringNoField Name
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_integration_kronos_business_structure_status

Gets a list of Employees for which there is a change in business structure Parameters:
ParameterTypeRequiredDefaultDescription
modifiedAfterDateTimestringYesModified After Date Time
companyIdstringYesCompany Id
effectiveDatestringNoEffective Date
employeeIdstringNoEmployee Id
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_integration_kronos_employee_profiles

Get list of employees profile Parameters:
ParameterTypeRequiredDefaultDescription
productstringYesThe product value
companyIdstringNoCompany Id
employeeIdstringNoEmployee Id
effectiveDatestringNoEffective Date
changeWindowintegerNoChange Window
includeHistoryIfChangeDetectedbooleanNoInclude History If Change Detected
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_open_enrollment_dep_deductions

Get Open Enrollment Dependent Deductions Data Parameters:
ParameterTypeRequiredDefaultDescription
startDateTimestringYesStart Date Time
endDateTimestringYesEnd Date Time
sessionTypestringYesSession Type
deductionCodestringYesDeduction Code
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_pto_plans

Get all pto-plans Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNoPagination, which page you want to see
per_pagenumberNoPagination, how many records per page you want to see

ukg-employee-admin_get_personnel_v1_user_defined_fields

Get User Defined Fields Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringNoCompany Id
employeeIdstringNoEmployee Id
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_get_personnel_v1_user_preferences

Get User Preferences Details Parameters:
ParameterTypeRequiredDefaultDescription
userIDstringNoUser ID
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_import_tool_get_file_status

Fetches the status of the file. Parameters:
ParameterTypeRequiredDefaultDescription
fileIdstringYesA unique identifier for the file.

ukg-employee-admin_import_tool_get_file_summary

Fetches a summary of the file. Parameters:
ParameterTypeRequiredDefaultDescription
fileIdstringYesA unique identifier for the file.
pageintegerNoThe number of pages in the file. Minimum = 1 and maximum = 2147483647.
per_PageintegerNoThe name of the file.

ukg-employee-admin_import_tool_get_status

Retrieves the status of an import tool transaction Parameters:
ParameterTypeRequiredDefaultDescription
stagingIdstringYesStaging Id

ukg-employee-admin_import_tool_get_transaction_status

Fetches the transaction name and status.

ukg-employee-admin_import_tool_imports_xml_data

Takes an XML transaction and feeds it into the Import Tool

ukg-employee-admin_import_tool_post

Takes an XML transaction and feeds it into the Import Tool Parameters:
ParameterTypeRequiredDefaultDescription
transactionstringNoThe XML Serialized transaction
uniqueFileNamestringNoAn optionally provided unique file name

ukg-employee-admin_kronos_employee_status_get

Get Employee Status Parameters:
ParameterTypeRequiredDefaultDescription
effectiveDatestringNoEffective Date
companyIdstringNoCompany Id
employeeIdsstringNoEmployee Ids
inactiveTermWindowintegerNoInactive Term Window
inactiveDisabledWindowintegerNoInactive Disabled Window
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_open_enrollment_employee_deductions_get_audit_details

Get Open Enrollment Employee Deductions Parameters:
ParameterTypeRequiredDefaultDescription
startDateTimestringYesStart Date Time
endDateTimestringYesEnd Date Time
sessionTypestringYesSession Type
deductionCodestringYesDeduction Code
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_patch_personnel_v1_companies_company_id_employees_employee_id_pto_plans_pto_plan

Patch one PTO Plan Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesCompany Identifier
employeeIdstringYesEmployee Identifier
ptoPlanstringYesPTO Plan Identifier
earnednumberNoAmount of hours earned for PTO
earnedThroughDatestringNoDate in which PTO is earned through, format should be YYYY-MM-DD
pendingBalancenumberNoBalance of PTO hours
pendingMoveDatestringNoDate to be used if pending rules are relevant, format should be YYYY-MM-DD
resetstringNoDate in which the PTO reset’s, format should be YYYY-MM-DD
takennumberNoAmount of hours taken for PTO

ukg-employee-admin_pay_deduction_element_get

Get Global Employee Payments and Deductions Service Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringNoCompany Id
employeeIdstringNoEmployee Id
countrystringNoThe country value
payGroupstringNoPay Group
payDeductionNamestringNoPay Deduction Name
periodStartNamestringNoPeriod Start Name
paymentOrDeductionIndicatorstringNoPayment Or Deduction Indicator
modifiedDatestringNoUsed to find a payment or deduction modified less than, greater than, equal to, or between passed date(s)
startDatestringNoUsed to find a payment or deduction where the pay period start is less than, greater than, equal to, or between passed date(s)
endDatestringNoUsed to find a payment or deduction where the pay period end is less than, greater than, equal to, or between passed date(s)
pageintegerNoPage number for pagination
per_PageintegerNoNumber of results per page

ukg-employee-admin_pc_fields_data_get_fields_data

Platform Configuration Fields Data v1 Parameters:
ParameterTypeRequiredDefaultDescription
classNamestringYesThe name of a supported class, as listed above, to pull custom fields from.
keyNamestringNoOptional keyName to allow filtering results by the corresponding keyValue. keyNames are specific IDs that apply to the class in question.
keyValuestringNoOptional keyValue. Allows filtering results to only include a specific keyValue(s). keyValues correspond to a supplied keyName.
fieldsstringNoThe exact name of a custom field or fields in a comma seperated list. Filters results to only fields with those names.
employmentStatusstringNoUse in junction with employment specific queries to filter custom field results by an internal employment status.
pageintegerNoOffsets results. Used with page number to allow filtering results to a specific range of custom fields.
per_PageintegerNoOffsets results. Used with page to allow filtering results to a specific range of custom fields.

ukg-employee-admin_pcfields_data_v2_get_fields_data

Platform Configuration Fields Data v2 Parameters:
ParameterTypeRequiredDefaultDescription
classNamestringYesThe name of a supported class, as listed above, to pull custom fields from.
fieldsstringNoThe exact name of a custom field or fields in a comma seperated list. Filters results to only fields with those names.
keyValuestringNokeyValue to filter results by, allowing filtering by specific Ids. This value is dependent on the className, as listed in the implementation notes.
pageintegerNoOffsets results. Used with page number to allow filtering results to a certain range of custom fields.
per_PageintegerNoOffsets results. Used with page to allow filtering results to a certain range of custom fields.

ukg-employee-admin_post_personnel_v1_pto_plans

Create A PTO Plan Parameters:
ParameterTypeRequiredDefaultDescription
bodyobject[]YesThe pto-plan to be written