---
title: "Get Employee Deductions [Batch]"
method: GET
path: "/apiHub/payroll/v1/companies/{companyId}/employees/{employeeId}/deductions"
tags: ["Recurring Deductions"]
---

# Get Employee Deductions \[Batch\]

`GET /apiHub/payroll/v1/companies/{companyId}/employees/{employeeId}/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}/employees/{employeeId}/deductions`
- Auth: none declared

**Summary Description**

This function will allow the API user to GET a list of all active deductions associated with the employee record.

## Path parameters

- `companyId` string, required
- `employeeId` string, required

## Query parameters

- `filter` string
- `limit` integer
- `offset` integer

## Headers

- `testMode` boolean

## Response `200`

OK

- GetDeductionDto[]
  - `id` string, uuid: Resource ID of the record
  - `employeeId` string, nullable: The Paylocity Employee ID. This is a unique value per Paylocity Company ID
  - `companyId` string, nullable: The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity
  - `code` string, nullable: Deduction Code
  - `type` string, nullable: Deduction Type
  - `rate` number, double, nullable: Rate for the Deduction
  - `arrear` number, double, nullable: Money that is owed
  - `frequency` string, nullable: Frequency determines how often the deduction Rate is applied in payroll
  - `calculationCode` string, nullable: Calculation Code that Applies to Deduction
  - `agencyCode` string, nullable: Agency Code. These are custom per client
  - `miscellaneousInfo` string, nullable: Miscellaneous Information
  - `priority` integer, nullable: Priority determines the order in which a deduction is subtracted from gross pay. Priorities 1-4 are reserved for Statutory deductions(necessary by law), while 5-7 are reserved for Voluntary deductions(employee-elected).
  - `selfInsured` boolean, nullable: Self-Insured Plan Flag. This will generate Part III of the employee's 1095-C Form
  - `recordType` 'Current' | 'Future' | 'Historical' | 'Unknown', nullable: The recordType field in our API plays a vital role in defining the current state of the record under consideration. This attribute can hold three different values, each describing a distinct temporal stage of the record. 1. **Historical**: If the recordType is set as 'Historical', it signifies that the record in question pertains to past data or events. This attribute is typically used for records that have been archived or are no longer active. 2. **Current**: A 'Current' recordType indicates that the record is active and relevant to the present time. These records are currently in use and contain up-to-date information. 3. **Future dated**: The 'Future dated' recordType is used for records that are scheduled for a future date. They represent planned or expected data or events. By using the recordType field, users can accurately categorize their records based on their temporal status, making it easier to sort, manage, and analyze data effectively.
  - `note` string, nullable: Deduction Notes
  - `effectiveDate` string, date-time, nullable: Effective Date of the Deduction
  - `beginCheckDate` string, date-time, nullable: Begin Check Date of the Deduction
  - `endCheckDate` string, date-time, nullable: End Check Date of the Deduction
  - `costCenters` CostCenterDto[], nullable: An array of objects representing the Cost Centers
    - `level` integer, nullable: Cost center level (Levels are 1-3)
    - `code` string, nullable: Cost Center Code associated with the Level. This must match a Paylocity Cost Center Code
  - `limits` GetLimitsDto: Limits are used to control the amount of an earning or deduction
    - `paidYearToDate` number, double, nullable: Amount Paid Year to Date
    - `goal` number, double, nullable: The Goal is the deduction/earning limit. When deductions/earnings have met the limit, the employee pay deductions/earnings will stop. For payroll, this amount is the lifetime deduction/earning limit. For benefits, this limit amount could be annual.
    - `paidToDate` number, double, nullable: Paid to Date tracks the amount paid toward the Goal. The Paid to Date amount will never be more than the Goal amount
    - `payPeriodMinimum` number, double, nullable: Minimum for the pay period
    - `payPeriodMaximum` number, double, nullable: Maximum for the pay period
    - `annualMaximum` number, double, nullable: Entering an amount in the Annual Maximum field will override the system setting, and you'll need to manually manage the maximum each year. Leave this field blank to keep the system setting.
  - `loan401K` Loan401KDto: A 401K loan is a type of loan that allows you to borrow money against the balance of your 401K retirement plan, up to a certain limit. It's a way for individuals to access their retirement savings without incurring early withdrawal penalties or taxes. The borrower is expected to repay the loan, typically over five years, through payroll deductions. The values to insert a loan, like Loan Number, and First Payment Date are provided by the record keeper.
    - `loanNumber` string, nullable: 401K Loan Number. Provided by Record Keeper
    - `issueDate` string, date-time, nullable: Date of 401K Loan Issued
    - `firstPaymentDate` string, date-time, nullable: First Payment Date of 401K Loan

---

[API](https://skmtc.dev/paylocity/apis/pay-setup-api.md) - [All operations](https://skmtc.dev/paylocity/apis/pay-setup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/pay-setup-api/revisions/d588d54cc4b6?raw)