GuidesAPI ReferenceChangelogAPI PolicyAPI StatusGusto Security
API Reference
These docs are for v2023-09-01. Click to read the latest docs for v2024-04-01.

Get an employee

Get an employee.

scope: employees:read

Path Params
string
required

The UUID of the employee

Query Params
string

Include the requested attribute(s) in each employee response, multiple options are comma separated. Available options:

  • all_compensations: Include all effective dated compensations for each job instead of only the current compensation
  • custom_fields: Include employees' custom fields
Headers
string

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

Responses

Response body
object
string
required

The UUID of the employee in Gusto.

string
required
string | null
string
required
string | null

The personal email address of the employee. This is provided to support syncing users between our system and yours. You may not use this email address for any other purpose (e.g. marketing).

string

The UUID of the company the employee is employed by.

string | null

The UUID of the employee's manager.

string

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

string | null

The employee's department in the company.

boolean

Whether the employee is terminated.

boolean | null

Whether the employee is a two percent shareholder of the company. This field only applies to companies with an S-Corp entity type.

boolean

Whether the employee has completed onboarding.

string

The current onboarding status of the employee

onboarding_completed admin_onboarding_incomplete self_onboarding_pending_invite self_onboarding_invited self_onboarding_invited_started self_onboarding_invited_overdue self_onboarding_completed_by_employee self_onboarding_awaiting_admin_review

jobs
array of objects
jobs
object
string
required

The UUID of the job.

string

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

string

The UUID of the employee to which the job belongs.

string

The date when the employee was hired or rehired for the job.

string | null
Defaults to null

The title for the job.

boolean

Whether this is the employee's primary job. The value will be set to true unless an existing job exists for the employee.

string

The current compensation rate of the job.

string

The payment unit of the current compensation for the job.

string

The UUID of the current compensation of the job.

boolean

Whether the employee owns at least 2% of the company.

boolean

Whether this job is eligible for workers' compensation coverage in the state of Washington (WA).

string

The risk class code for workers' compensation in Washington state. Please visit Washington state's Risk Class page to learn more.

compensations
array of objects
compensations
object
string
required

The UUID of the compensation in Gusto.

string

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

string

The UUID of the job to which the compensation belongs.

string

The dollar amount paid per payment unit.

string

The unit accompanying the compensation rate. If the employee is an owner, rate should be 'Paycheck'.

Hour Week Month Year Paycheck

string

The FLSA status for this compensation. Salaried ('Exempt') employees are paid a fixed salary every pay period. Salaried with overtime ('Salaried Nonexempt') employees are paid a fixed salary every pay period, and receive overtime pay when applicable. Hourly ('Nonexempt') employees are paid for the hours they work, and receive overtime pay when applicable. Commissioned employees ('Commission Only Exempt') earn wages based only on commission. Commissioned with overtime ('Commission Only Nonexempt') earn wages based on commission, and receive overtime pay when applicable. Owners ('Owner') are employees that own at least twenty percent of the company.

Exempt Salaried Nonexempt Nonexempt Owner Commission Only Exempt Commission Only Nonexempt

string

The effective date for this compensation. For the first compensation, this defaults to the job's hire date.

boolean

Indicates if the compensation could be adjusted to minimum wage during payroll calculation.

eligible_paid_time_off
array of objects
eligible_paid_time_off
object
string

The name of the paid time off type.

Vacation Hours Sick Hours Holiday Hours

string

The name of the time off policy.

string

The UUID of the time off policy.

string

The unit the PTO type is accrued in.

string

The number of accrual units accrued per accrual period.

string

The accrual method of the time off policy

string

The frequency at which the PTO type is accrued.

string

The number of accrual units accrued.

string | null

The maximum number of accrual units allowed. A null value signifies no maximum.

boolean

Whether the accrual balance is paid to the employee upon termination.

terminations
array of objects
terminations
object
string
required

The UUID of the termination object.

string

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

integer

The UUID of the employee to which this termination is attached.

boolean

Whether the employee's termination has gone into effect.

boolean

Whether the employee's termination is cancelable. Cancelable is true if run_termination_payroll is false and effective_date is in the future.

string

The employee's last day of work.

boolean

If true, the employee should receive their final wages via an off-cycle payroll. If false, they should receive their final wages on their current pay schedule.

garnishments
array of objects
garnishments
object
string
required

The UUID of the garnishment in Gusto.

string

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

string

The UUID of the employee to which this garnishment belongs.

boolean
Defaults to true

Whether or not this garnishment is currently active.

string

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

string

The description of the garnishment.

boolean

Whether the garnishment is court ordered.

integer | null
Defaults to null

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

boolean
Defaults to false

Whether the garnishment should recur indefinitely.

string | null
Defaults to null

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

string | null
Defaults to null

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

boolean
Defaults to false

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

string | null

The specific type of garnishment for court ordered garnishments.

child_support federal_tax_lien state_tax_lien student_loan creditor_garnishment federal_loan other_garnishment

object | null

Additional child support order details

custom_fields
array of objects

Custom fields are only included for the employee if the include param has the custom_fields value set

custom_fields
object
string
required
string
required

This is the id of the response object from when you get the company custom fields

string
required
string
required

Input type for the custom field.

text currency number date radio

string
string
required
array of strings | null

An array of options for fields of type radio. Otherwise, null.

selection_options
string | null
boolean

Indicates whether the employee has an SSN in Gusto.

string

Deprecated. This field always returns an empty string.

string | null
string | null
string
Defaults to Check

The employee's payment method

Direct Deposit Check

string | null

The work email address of the employee. This is provided to support syncing users between our system and yours. You may not use this email address for any other purpose (e.g. marketing).

string | null

The current employment status of the employee. Full-time employees work 30+ hours per week. Part-time employees are split into two groups: those that work 20-29 hours a week, and those that work under 20 hours a week. Variable employees have hours that vary each week. Seasonal employees are hired for 6 months of the year or less.

full_time part_time_under_twenty_hours part_time_twenty_plus_hours variable seasonal

404

Not Found

The requested resource does not exist. Make sure the provided ID/UUID is valid.

Language
Credentials