Payroll/HR

Get Deduction Codes

Summary Description

The GET Deduction Codes by list by Company ID endpoint allows users to retrieve a comprehensive list of Deduction Codes details from a client's Paylocity instance. To use this endpoint, the Paylocity “deductions” parameter must be specified. Deduction Codes are alphanumeric or numeric identifiers used in financial and accounting systems to categorize and track various types of deductions. These deductions can include expenses, withholdings, reductions in pay, or other adjustments made to an individual's or organization's financial records. Pagination can be achieved by using the "deductions" parameter and specifying the values of "limit" and "offset" to decide the quantity of records to be retrieved. The utilization of the "limit" option permits the user to restrict the quantity of rows that are retrieved from a query, whereas the "offset" option enables the omission of a designated number of rows preceding the commencement of the result set. The utilization of both the limit and offset parameters in a query allows for the skipping of rows as well as the restriction of the number of rows returned.

Use Cases

Accounts Receivable: Deduction codes can be utilized to monitor discounts, allowances, or modifications applied to invoices or accounts payable.
Taxes: Various tax jurisdictions employ deduction codes to describe the specific sort of tax being subtracted, such as federal income tax, state income tax, or local taxes.
Advantages: Deduction codes can be utilized to classify deductions associated with employee benefits like as health insurance, dental coverage, or retirement plans.
Loans and Debts: Lenders and financial organizations utilize deduction codes to precisely indicate the reason for deductions made for loan repayments, interest, or fees.
Expense Reporting: Deduction codes are utilized in company cost reporting to classify and monitor several types of spending, including travel, meals, entertainment, and office supplies.

get/apiHub/payroll/v1/companies/{companyId}/deductions

Request

Base URL
dc1demogwext.paylocity.com (relative, and the document’s source URL is not known)
URL
dc1demogwext.paylocity.com/apiHub/payroll/v1/companies/{companyId}/deductions
Auth
none declared

Path parameters

companyIdstring required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity. Allowable Values: 9 char max

Query parameters

includeTotalCountboolean

A boolean value representing whether the API should return the total number of resources available (even though only a subset may be returned). When includeTotalCount=true, then the X-Pcty-Total-Count response header should be added to the response and will specify the total number of records available. APIs that support X-Pcty-Total-Count should include this parameter in their specification.

offsetinteger

Pagination offset.

limitinteger

Number of deduction codes per page. Default Value: 20 Maximum Value: 100

Headers

Authorizationstring

Authorization token. Ex. Bearer ...

testModeboolean

If true all responses are mocked and generated randomly.

Response

companyIdstring nullable

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.

codestring nullable

A distinct code representing a specific entity or item, serving as a concise reference for accurate identification and categorization.

descriptionstring nullable

A detailed textual explanation or label providing additional context and meaning to the associated code or entity.

checkStubDescriptionstring nullable

A descriptive text that appears on an employee's check stub, offering transparency and clarity regarding payment details.

priorityinteger nullable

An indicator defining the priority or ranking of an item, allowing for prioritization and sorting within a specific context.

w2Boxstring nullable

The W2 box code associated with the deduction.

printOnCheckStubboolean nullable

An indicator specifying whether the associated information or description should be printed on an employee's check stub.

payPeriodMaximumnumber double nullable

The maximum amount deducted per pay period.

payPeriodMinimumnumber double nullable

The minimum amount deducted per pay period.

annualMaximumnumber double nullable

The maximum annual deduction amount.

ratenumber double nullable

A numerical representation of a specific rate or value, often utilized in financial calculations and compensation structures.

frequencystring nullable

The frequency of the deduction (e.g., monthly, weekly).

calculationCodestring nullable

A code used in calculations to determine specific values or outcomes, aiding in complex computation scenarios.

amountnumber double nullable

The fixed amount of the deduction.

kCodestring nullable

A code or identifier, often unique to a particular context, facilitating specialized categorization or classification.

agencystring nullable

The agency or entity responsible for the deduction.

takePartialboolean nullable

An indicator specifying whether partial deductions or actions should be taken, allowing for nuanced processing.

autoMakeupboolean nullable

An indicator defining whether automatic makeup or adjustments should be applied under specific conditions or criteria.

isActiveboolean nullable

An indicator denoting the current status or active state of an entity or item, aiding in management and decision-making.

includeOnYtdCompChartboolean nullable

An indicator specifying whether the data should be included on a year-to-date compensation chart or report.

sourceinteger nullable

The origin or source of data, indicating where the information was derived or obtained from within the system.

wasUsedInPayrollboolean nullable

An indicator confirming whether the data was utilized in payroll processing, ensuring transparency in payroll calculations.

benefitTypestring nullable

The type or category of the deduction (e.g., health, retirement).

selfInsuredboolean nullable

An indicator indicating whether an entity or item is self-insured, meaning it assumes responsibility for insurance coverage.

isEmployerPaidMedicalLeaveboolean nullable

An indicator specifying whether an entity or item is related to employer-paid medical leave, offering clarity on benefit coverage.

exemptTaxesstring[] nullable

A field indicating which taxes are exempted or excluded in specific scenarios, aiding in tax-related calculations and reporting.

blockedTaxesstring[] nullable

A field specifying taxes that are blocked or restricted from certain calculations or processes, ensuring accurate taxation.

Changes

No recorded changes to this operation across all 1 revision of this API.