---
title: "employee deductions"
method: GET
path: "/v{version}/companies/{id}/deductions"
tags: ["Company"]
---

# employee deductions

`GET /v{version}/companies/{id}/deductions`

Returns a list of paginated employee deductions for the company.<p>Scopes: export_payroll</p>

## Path parameters

- `id` string, required
- `version` string, required

## Query parameters

- `pay_group_id` string
- `employee_id` string
- `employee_start_id` string
- `employee_limit` integer

## Response `200`

OK

- 0PagedWrappedArrayEmployeeDeduction
  - `next_id` string — The id of the object next up after this set.
  - `data` DtosEmployeeDeduction[], required — An array containing the list of relevant objects.
    - `coverage_line_id` string, required
    - `employee_deduction_id` string, required
    - `employee_id` string, required
    - `amount` number, double, required — The amount for the deduction.
    - `amount_type` 'Dollar' | 'Percent', required — The amount type for the deduction.
    - `start_date` string, required — The start date of the deduction.
    - `end_date` string, required — The end date of the deduction. Deductions are considered voided if the start date follows the end date.
    - `annual_deduction_id` string, required — The deduction id for the calendar year.
    - `employer_amount_type` 'Dollar' | 'Percent', required
    - `employer_amount` number, double
    - `annual_cap` number, double
    - `last_modified` string, date-time
    - `employer_monthly_amount` number, double — The monthly amount for the employer portion.
    - `monthly_amount` number, double — The monthly amount fo the employee portion.
    - `coverage_tier` 'Employee Only' | 'Employee + 1 Child' | 'Employee + 2 Children' | 'Employee + 3 Children' | 'Employee + Spouse' | 'Employee + Spouse + 1 Child' | 'Employee + Spouse + 2 Children' | 'Employee + Spouse + 3 Children' — The coverage tier in effect for this deduction.
    - `includes_domestic_partner` boolean — Determines whether or not this deduction period includes domestic partners.
    - `is_cobra` boolean — Determines whether or not this is a COBRA deduction.
  - `error` string — Contains any error messages, if applicable.

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)