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

Tools

ToolDescription
workday_payroll_delete_payrollinputs_by_idDeletes an existing payroll input instance.
workday_payroll_get_jobsRetrieves a collection of jobs.
workday_payroll_get_jobs_by_idRetrieves a single job instance.
workday_payroll_get_jobs_by_id_paygroupRetrieves the pay group for a specified job ID. This method always returns 1 pay group.
workday_payroll_get_jobs_by_id_paygroup_by_subresourceidRetrieves a single pay group instance.
workday_payroll_get_minimumwageratesRetrieves a collection of minimum wage rates.
workday_payroll_get_minimumwagerates_by_idRetrieves a collection of minimum wage rates.
workday_payroll_get_paygroupdetailsRetrieves a collection of pay group details.
workday_payroll_get_paygroupdetails_by_idRetrieves a single pay group detail instance.
workday_payroll_get_paygroupsRetrieves a collection of pay groups.
workday_payroll_get_paygroups_by_idRetrieves a single pay group instance.
workday_payroll_get_payrollinputsRetrieves a collection of payroll inputs. At least 1 query parameter is required to get data.
workday_payroll_get_payrollinputs_by_idRetrieves a single payroll input instance.
workday_payroll_get_taxratesRetrieves a single or a collection of company SUI rates.
workday_payroll_get_values_minimumwageratesgroup_countriesRetrieves a list of all countries available as query parameters in the /minimumWageRates endpoint. <b>Secured by:</b> Set Up: Payroll (Minimum Wages View) - CAN, Set Up: Payroll (Minimum Wages View) - USA, Set Up: Payroll Authority Minimum Wages View (Compensation functional area) <b>Scope:</b> CAN Payroll, Core Compensation, USA Payroll
workday_payroll_get_values_minimumwageratesgroup_taxauthoritiesRetrieves a list of tax authorities available for use as query parameters in the /minimumWageRates endpoint. <b>Secured by:</b> Set Up: Payroll (Minimum Wages View) - CAN, Set Up: Payroll (Minimum Wages View) - USA, Set Up: Payroll Authority Minimum Wages View (Compensation functional area) <b>Scope:</b> CAN Payroll, Core Compensation, USA Payroll
workday_payroll_get_values_payrollinputsgroup_paycomponentsRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll
workday_payroll_get_values_payrollinputsgroup_positionsRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll
workday_payroll_get_values_payrollinputsgroup_runcategoriesRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll
workday_payroll_get_values_payrollinputsgroup_worktagsRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll
workday_payroll_get_values_taxratesgroup_companyinstancesRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Process: Tax Filing/W-2s (Run) - USA <b>Scope:</b> USA Payroll
workday_payroll_get_values_taxratesgroup_stateinstancesRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Process: Tax Filing/W-2s (Run) - USA <b>Scope:</b> USA Payroll
workday_payroll_patch_payrollinputs_by_idPartially updates an existing payroll input instance.
workday_payroll_post_payrollinputsCreates payroll inputs.
workday_payroll_post_taxratesCreates a single or a collection of Company SUI Rates.

workday_payroll_delete_payrollinputs_by_id

Deletes an existing payroll input instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_payroll_get_jobs

Retrieves a collection of jobs. Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.

workday_payroll_get_jobs_by_id

Retrieves a single job instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_payroll_get_jobs_by_id_paygroup

Retrieves the pay group for a specified job ID. This method always returns 1 pay group. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.
effectivestringNoThe effective date of the pay group, using the date format yyyy-mm-dd.
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.

workday_payroll_get_jobs_by_id_paygroup_by_subresourceid

Retrieves a single pay group instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.
subresourceIDstringYesThe Workday ID of the subresource.

workday_payroll_get_minimumwagerates

Retrieves a collection of minimum wage rates. Parameters:
ParameterTypeRequiredDefaultDescription
asOfDatestringNoThe minimum wage rates that are effective on the date specified using the yyyy-mm-dd format.
countrystringNoThe Workday ID of the country for the minimum wages rates. You can use a returned id from GET /values/minimumWageRatesGroup/countries. You can specify 1 country query parameter. Example: country=country.
includeLocalTaxAuthoritiesbooleanNoIf true, returns minimum wage rates for local tax authorities, such as cities and counties, in addition to federal and state rates. If false (default), only returns federal and state minimum wage rates.
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
taxAuthorityany[]NoThe Workday ID of the payroll tax authority for the minimum wages rates. You can use a returned id from GET /values/minimumWageRatesGroup/taxAuthorities. You can specify 1 or more tax authority query parameters. Example: taxAuthority=taxAuthority1&taxAuthority=taxAuthority2.

workday_payroll_get_minimumwagerates_by_id

Retrieves a collection of minimum wage rates. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_payroll_get_paygroupdetails

Retrieves a collection of pay group details. Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
runCategoriesany[]NoOne or more Workday IDs of run categories for the pay group. You can use returned ids from GET /values/payrollInputsGroup/runCategories.You can specify 1 or more runCategories query parameters, example: runCategories=category1&runCategories=category2

workday_payroll_get_paygroupdetails_by_id

Retrieves a single pay group detail instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_payroll_get_paygroups

Retrieves a collection of pay groups. Parameters:
ParameterTypeRequiredDefaultDescription
countrystringNoThe Workday ID of the country or territory of the pay group. You can use a returned country id from any of the payGroups endpoints in this Payroll API.
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.

workday_payroll_get_paygroups_by_id

Retrieves a single pay group instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_payroll_get_payrollinputs

Retrieves a collection of payroll inputs. At least 1 query parameter is required to get data. Parameters:
ParameterTypeRequiredDefaultDescription
endDatestringNoThe end date filter which returns payroll inputs that are active on or before the end date, using the date format yyyy-mm-dd.
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
payComponentany[]NoThe Workday ID of the pay component for the payroll input. You can use a returned id from GET /values/payrollInputsGroup/payComponents.
startDatestringNoThe start date filter which returns payroll inputs that are active on or after the start date, using the date format yyyy-mm-dd.
workerany[]NoThe Workday ID of worker for the payroll input. You can use a returned id from GET /workers in the Staffing service.

workday_payroll_get_payrollinputs_by_id

Retrieves a single payroll input instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_payroll_get_taxrates

Retrieves a single or a collection of company SUI rates. Parameters:
ParameterTypeRequiredDefaultDescription
companystringNoThe company reference ID or WID that represents 1 or more companies. Example: company=comp1&company=comp2&company=cb550da820584750aae8f807882fa79a
effectivestringNoThe effective date for the SUI rate, using the yyyy-mm-dd format.
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
payrollStateAuthorityTaxCodestringNoThe FIPS code or WID that represents 1 or more states. Example: payrollStateAuthorityTaxCode=06&payrollStateAuthorityTaxCode=3b3d378d5f4a48b8b3ac46fee0703226&payrollStateAuthorityTaxCode=48

workday_payroll_get_values_minimumwageratesgroup_countries

Retrieves a list of all countries available as query parameters in the /minimumWageRates endpoint. <b>Secured by:</b> Set Up: Payroll (Minimum Wages View) - CAN, Set Up: Payroll (Minimum Wages View) - USA, Set Up: Payroll Authority Minimum Wages View (Compensation functional area) <b>Scope:</b> CAN Payroll, Core Compensation, USA Payroll Parameters:
ParameterTypeRequiredDefaultDescription
countrystringNoThe Workday ID of the country for the tax authorities. You can use a returned id from GET /values/minimumWageRatesGroup/countries. You can specify 1 country query parameter. Example: country=country.
includeLocalTaxAuthoritiesbooleanNoIf true, returns local tax authorities, such as cities and counties, in addition to federal and state tax authorities. If false (default), only returns federal and state tax authorities.
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.

workday_payroll_get_values_minimumwageratesgroup_taxauthorities

Retrieves a list of tax authorities available for use as query parameters in the /minimumWageRates endpoint. <b>Secured by:</b> Set Up: Payroll (Minimum Wages View) - CAN, Set Up: Payroll (Minimum Wages View) - USA, Set Up: Payroll Authority Minimum Wages View (Compensation functional area) <b>Scope:</b> CAN Payroll, Core Compensation, USA Payroll Parameters:
ParameterTypeRequiredDefaultDescription
countrystringNoThe Workday ID of the country for the tax authorities. You can use a returned id from GET /values/minimumWageRatesGroup/countries. You can specify 1 country query parameter. Example: country=country.
includeLocalTaxAuthoritiesbooleanNoIf true, returns local tax authorities, such as cities and counties, in addition to federal and state tax authorities. If false (default), only returns federal and state tax authorities.
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.

workday_payroll_get_values_payrollinputsgroup_paycomponents

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll Parameters:
ParameterTypeRequiredDefaultDescription
endDatestringNoThe end date for the positions, using the date format yyyy-mm-dd.
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
payComponentstringNoThe pay component for the worktags. You can use a returned id from GET/values/payrollInputsGroup/payComponents.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.
startDatestringNoThe start date for the positions, using the date format yyyy-mm-dd.
workerstringNoThe Workday ID of the worker. You can use a returned id from GET /workers in the Staffing service.

workday_payroll_get_values_payrollinputsgroup_positions

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll Parameters:
ParameterTypeRequiredDefaultDescription
endDatestringNoThe end date for the positions, using the date format yyyy-mm-dd.
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
payComponentstringNoThe pay component for the worktags. You can use a returned id from GET/values/payrollInputsGroup/payComponents.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.
startDatestringNoThe start date for the positions, using the date format yyyy-mm-dd.
workerstringNoThe Workday ID of the worker. You can use a returned id from GET /workers in the Staffing service.

workday_payroll_get_values_payrollinputsgroup_runcategories

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll Parameters:
ParameterTypeRequiredDefaultDescription
endDatestringNoThe end date for the positions, using the date format yyyy-mm-dd.
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
payComponentstringNoThe pay component for the worktags. You can use a returned id from GET/values/payrollInputsGroup/payComponents.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.
startDatestringNoThe start date for the positions, using the date format yyyy-mm-dd.
workerstringNoThe Workday ID of the worker. You can use a returned id from GET /workers in the Staffing service.

workday_payroll_get_values_payrollinputsgroup_worktags

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Worker Data: Payroll Public API (Payroll Input) <b>Scope:</b> Core Payroll Parameters:
ParameterTypeRequiredDefaultDescription
endDatestringNoThe end date for the positions, using the date format yyyy-mm-dd.
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
payComponentstringNoThe pay component for the worktags. You can use a returned id from GET/values/payrollInputsGroup/payComponents.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.
startDatestringNoThe start date for the positions, using the date format yyyy-mm-dd.
workerstringNoThe Workday ID of the worker. You can use a returned id from GET /workers in the Staffing service.

workday_payroll_get_values_taxratesgroup_companyinstances

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Process: Tax Filing/W-2s (Run) - USA <b>Scope:</b> USA Payroll Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.

workday_payroll_get_values_taxratesgroup_stateinstances

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Process: Tax Filing/W-2s (Run) - USA <b>Scope:</b> USA Payroll Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.

workday_payroll_patch_payrollinputs_by_id

Partially updates an existing payroll input instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.
adjustmentbooleanNoIf true, the input is for an adjustment as opposed to an override.
commentstringNoThe text comment for this input.
currencyobjectNoThe currency for the payroll input. If no currency exists, the system assumes the Pay Group currency. The Pay Group currency is derived from the default currency for the Pay Group country.
descriptorstringNoThe display name of the instance
endDatestringNoThe end date after which this input does not apply.
fieldEditabilitystringNoThe editability status indicating the fields that can be updated in the payroll input request. Possible values: all, none, endDateOnly
idstringNoWorkday Id or Reference Id of the instance.
inputDetailsany[]NoThe details for this payroll input.
ongoingbooleanNoIf true, the payroll input is ongoing.
payComponentobjectNoThe pay component for this payroll input.
positionobjectNoThe worker’s position the payroll input applies to if Multi Job Payroll is used.
runCategoriesany[]NoThe run category for the payroll input.
startDatestringNoThe start date before which this input does not apply.
workerobjectNoThe worker for this payroll input.
worktagsany[]NoThe worktags associated with the payroll input.

workday_payroll_post_payrollinputs

Creates payroll inputs. Parameters:
ParameterTypeRequiredDefaultDescription
adjustmentbooleanNoIf true, the input is for an adjustment as opposed to an override.
commentstringNoThe text comment for this input.
currencyobjectNoThe currency for the payroll input. If no currency exists, the system assumes the Pay Group currency. The Pay Group currency is derived from the default currency for the Pay Group country.
descriptorstringNoThe display name of the instance
endDatestringNoThe end date after which this input does not apply.
fieldEditabilitystringNoThe editability status indicating the fields that can be updated in the payroll input request. Possible values: all, none, endDateOnly
idstringNoWorkday Id or Reference Id of the instance.
inputDetailsany[]NoThe details for this payroll input.
ongoingbooleanNoIf true, the payroll input is ongoing.
payComponentobjectNoThe pay component for this payroll input.
positionobjectNoThe worker’s position the payroll input applies to if Multi Job Payroll is used.
runCategoriesany[]NoThe run category for the payroll input.
startDatestringNoThe start date before which this input does not apply.
workerobjectNoThe worker for this payroll input.
worktagsany[]NoThe worktags associated with the payroll input.

workday_payroll_post_taxrates

Creates a single or a collection of Company SUI Rates. Parameters:
ParameterTypeRequiredDefaultDescription
applicableRatestringNoThe tax override rate for company tax reporting.
companyInstanceobjectYesThe company object for company tax reporting.
einstringNoThe payroll tax authority EIN field for company tax reporting.
endDatestringNoThe end date for company tax reporting.
exemptbooleanNoIf true, the SUI rate is exempt.
idstringNoWorkday Id or Reference Id of the instance.
startDatestringYesThe start date for company tax reporting.
stateInstanceobjectYesThe payroll tax authority object for company tax reporting.
taxCodestringYesThe deduction for company tax reporting.