---
title: "Get garnishments for an employee"
method: GET
path: "/v1/employees/{employee_id}/garnishments"
tags: ["Garnishments"]
---

# Get garnishments for an employee

`GET /v1/employees/{employee_id}/garnishments`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/employees/{employee_id}/garnishments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/employees/:employee_id/garnishments/get.ts> (a function with typed inputs; its response is checked against the schema)

Garnishments, or employee deductions, are fixed amounts or percentages deducted from an employee’s pay. They can be deducted a specific number of times or on a recurring basis. Garnishments can also have maximum deductions on a yearly or per-pay-period bases. Common uses for garnishments are court-ordered payments for child support or back taxes. Some companies provide loans to their employees that are repaid via garnishments.

scope: `garnishments:read`

## Path parameters

- `employee_id` string, required

## Query parameters

- `page` integer
- `per` integer

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Example response

- Garnishment[]
  - `uuid` string, required: The UUID of the garnishment in Gusto.
  - `version` string: The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `employee_uuid` string: The UUID of the employee to which this garnishment belongs.
  - `active` boolean: Whether or not this garnishment is currently active.
  - `amount` string, float: The amount of the garnishment. Either a percentage or a fixed dollar amount. Represented as a float, e.g. "8.00". Child-support percentages cannot exceed 65; applicable federal or state rules may require a lower limit.
  - `description` string: The description of the garnishment.
  - `court_ordered` boolean: Whether the garnishment is court ordered. Must remain true for specific garnishment types other than other_garnishment.
  - `times` integer, nullable: The number of times to apply the garnishment. Must be a positive integer when creating or changing a non-recurring count. Updates may echo an unchanged legacy zero. Ignored if recurring is true; use recurring rather than a negative count for indefinite deductions.
  - `recurring` boolean: Whether the garnishment should recur indefinitely.
  - `annual_maximum` string, float, nullable: The maximum deduction per annum. A null value indicates no maximum. Represented as a float, e.g. "200.00".
  - `total_amount` string, float, nullable: A maximum total deduction for the lifetime of this garnishment. A null value indicates no maximum.
  - `pay_period_maximum` string, float, nullable: The maximum deduction per pay period. A null value indicates no maximum. Represented as a float, e.g. "16.00".
  - `deduct_as_percentage` boolean: Whether the amount should be treated as a percentage to be deducted per pay period.
  - `garnishment_type` 'child_support' | 'federal_tax_lien' | 'state_tax_lien' | 'student_loan' | 'creditor_garnishment' | 'federal_loan' | 'other_garnishment', nullable: The specific type of garnishment for court ordered garnishments.
  - `child_support` GarnishmentChildSupport, nullable: Additional child support order details
    - `state` string: The two letter state abbreviation for the state issuing the child support order. Agency data is available in the `GET /v1/garnishments/child_support` API.
    - `payment_period` 'Every week' | 'Every other week' | 'Twice per month' | 'Monthly': How often the agency collects the withholding amount. e.g. $500 monthly -> `Monthly`.
    - `fips_code` string: The FIPS code associated with the state or county agency issuing the child support order. Agency data is available in the `GET /v1/garnishments/child_support` API.
    - `case_number` string, nullable: Child Support Enforcement Case Number associated with this child support obligation - required for most states. Agency specific requirements are available in the `GET /v1/garnishments/child_support` API.
    - `order_number` string, nullable: Order Identifier or Order ID associated with this child support obligation - required for some states. Agency specific requirements are available in the `GET /v1/garnishments/child_support` API.
    - `remittance_number` string, nullable: Child Support Enforcement Remittance ID associated with this child support obligation - required for some states. Agency specific requirements are available in the `GET /v1/garnishments/child_support` API.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.

## Changes

- **2026-11-03** `f98575fa2a5e`: 4 info
  - the `annual_maximum` response's property default value `` was added for the status `200`
  - the `pay_period_maximum` response's property default value `` was added for the status `200`
  - the `times` response's property default value `` was added for the status `200`
  - the `total_amount` response's property default value `` was added for the status `200`

[Operation history](https://skmtc.dev/gusto/apis/gusto-api/changes/v1/employees/:employee_id/garnishments/get.md)

---

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