v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Garnishments

Get garnishments for an employee

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

get/v1/employees/{employee_id}/garnishments

Path parameters

employee_idstring required

The UUID of the employee

Query parameters

pageinteger

The page that is requested. When unspecified, will load all objects unless endpoint forces pagination.

perinteger

Number of objects per page. For majority of endpoints will default to 25

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Example response

uuidstring required

The UUID of the garnishment in Gusto.

versionstring

The current version of the object. See the versioning guide for information on how to use this field.

employee_uuidstring

The UUID of the employee to which this garnishment belongs.

activeboolean

Whether or not this garnishment is currently active.

amountstring float

The amount of the garnishment. Either a percentage or a fixed dollar amount. Represented as a float, e.g. "8.00".

descriptionstring

The description of the garnishment.

court_orderedboolean

Whether the garnishment is court ordered.

timesinteger nullable

The number of times to apply the garnishment. Ignored if recurring is true.

recurringboolean

Whether the garnishment should recur indefinitely.

annual_maximumstring float nullable

The maximum deduction per annum. A null value indicates no maximum. Represented as a float, e.g. "200.00".

total_amountstring float nullable

A maximum total deduction for the lifetime of this garnishment. A null value indicates no maximum.

pay_period_maximumstring float nullable

The maximum deduction per pay period. A null value indicates no maximum. Represented as a float, e.g. "16.00".

deduct_as_percentageboolean

Whether the amount should be treated as a percentage to be deducted per pay period.

The specific type of garnishment for court ordered garnishments.