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

# Get an employee

`GET /v1/employees/{employee_id}`

Get an employee.

Note: Compensation data (pay rate, payment unit, and related fields) represents sensitive employee pay information. When retrieving employee job data, these fields (`rate`, `payment_unit`, `current_compensation_uuid`, `compensations`) are only returned when the `compensations:read` scope is included. This allows you to access employee and job metadata without exposing pay rates.

scope: `employees:read`

## Path parameters

- `employee_id` string, required

## Query parameters

- `include` string[]

## Headers

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

## Response `200`

successful

- Employee — The representation of an employee in Gusto.
  - `uuid` string, required — The UUID of the employee in Gusto.
  - `first_name` string, required
  - `middle_initial` string, nullable
  - `last_name` string, required
  - `email` string, nullable — 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).
  - `company_uuid` string — The UUID of the company the employee is employed by.
  - `manager_uuid` string, nullable — The UUID of the employee's manager.
  - `version` string — The current version of the employee. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `department` string, nullable — The employee's department in the company.
  - `terminated` boolean — Whether the employee is terminated.
  - `two_percent_shareholder` boolean, nullable — Whether the employee is a two percent shareholder of the company. This field only applies to companies with an S-Corp entity type.
  - `work_email` string, nullable — 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).
  - `onboarded` boolean — Whether the employee has completed onboarding.
  - `onboarding_status` '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', nullable — The current onboarding status of the employee
  - `onboarding_documents_config` object — Configuration for an employee onboarding documents during onboarding
    - `uuid` string, nullable — The UUID of the onboarding documents config
    - `i9_document` boolean — Whether to include Form I-9 for an employee during onboarding
  - `jobs` Job[]
    - `uuid` string, required — The UUID of the job.
    - `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 the job belongs.
    - `hire_date` string — The date when the employee was hired or rehired for the job.
    - `title` string, nullable — The title for the job.
    - `primary` boolean — Whether this is the employee's primary job. The value will be set to true unless an existing job exists for the employee.
    - `rate` string — The employee's pay rate for this job (e.g., hourly wage or annual salary). This is sensitive compensation data and requires the `compensations:read` scope.
    - `payment_unit` string, nullable — How the employee is paid for this job (e.g., Hour, Week, Month, Year, Paycheck). This is sensitive compensation data and requires the `compensations:read` scope.
    - `current_compensation_uuid` string — The UUID of the current active compensation record for this job. Requires the `compensations:read` scope.
    - `two_percent_shareholder` boolean — Whether the employee owns at least 2% of the company.
    - `state_wc_covered` boolean, nullable — Whether this job is eligible for workers' compensation coverage in the state of Washington (WA).
    - `state_wc_class_code` string, nullable — The risk class code for workers' compensation in Washington state. Please visit [Washington state's Risk Class page](https://www.lni.wa.gov/insurance/rates-risk-classes/risk-classes-for-workers-compensation/risk-class-lookup#/) to learn more.
    - `compensations` Compensation[] — The compensation history for this job, including pay rate, payment unit, FLSA status, and effective dates. This is sensitive pay information and requires the `compensations:read` scope.
      - `uuid` string, required — The UUID of the compensation 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.
      - `job_uuid` string — The UUID of the job to which the compensation belongs.
      - `employee_uuid` string — The UUID of the employee to which the compensation belongs.
      - `rate` string — The dollar amount paid per payment unit.
      - `payment_unit` 'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck' — The unit accompanying the compensation rate. If the employee is an owner, rate should be 'Paycheck'.
      - `flsa_status` 'Exempt' | 'Salaried Nonexempt' | 'Nonexempt' | 'Owner' | 'Commission Only Exempt' | 'Commission Only Nonexempt' — 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.
      - `title` string — The job title for this compensation.
      - `effective_date` string — The effective date for this compensation. For the first compensation, this defaults to the job's hire date.
      - `adjust_for_minimum_wage` boolean — Indicates if the compensation could be adjusted to minimum wage during payroll calculation.
      - `minimum_wages` object[] — The minimum wages associated with the compensation.
        - `uuid` string — The UUID of the minimum wage.
        - `wage` string — The wage amount.
        - `effective_date` string — The effective date of the minimum wage.
    - `location_uuid` string — The uuid of the employee's work location.
    - `location` Location — The representation of an address in Gusto.
      - `uuid` string, required — The UUID of the location object.
      - `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.
      - `company_uuid` string — The UUID for the company to which the location belongs. Only included if the location belongs to a company.
      - `phone_number` string — The phone number for the location. Required for company locations. Optional for employee locations.
      - `street_1` string
      - `street_2` string, nullable
      - `city` string
      - `state` string
      - `zip` string
      - `country` string
      - `mailing_address` boolean — Specifies if the location is the company's mailing address. Only included if the location belongs to a company.
      - `filing_address` boolean — Specifies if the location is the company's filing address. Only included if the location belongs to a company.
      - `created_at` string — Datetime for when location is created
      - `updated_at` string — Datetime for when location is updated
      - `active` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.
      - `inactive` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.
  - `eligible_paid_time_off` PaidTimeOff[]
    - `name` 'Vacation Hours' | 'Sick Hours' | 'Holiday Hours', nullable — The name of the paid time off type.
    - `policy_name` string, nullable — The name of the time off policy.
    - `policy_uuid` string, nullable — The UUID of the time off policy.
    - `accrual_unit` string, nullable — The unit the PTO type is accrued in.
    - `accrual_rate` string, nullable — The number of accrual units accrued per accrual period.
    - `accrual_method` string, nullable — The accrual method of the time off policy
    - `accrual_period` string, nullable — The frequency at which the PTO type is accrued.
    - `accrual_balance` string, nullable — The number of accrual units accrued.
    - `maximum_accrual_balance` string, nullable — The maximum number of accrual units allowed. A null value signifies no maximum.
    - `paid_at_termination` boolean — Whether the accrual balance is paid to the employee upon termination.
  - `terminations` Termination[]
    - `uuid` string, required — The UUID of the termination object.
    - `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 termination is attached.
    - `active` boolean — Whether the employee's termination has gone into effect.
    - `cancelable` boolean — Whether the employee's termination is cancelable. Cancelable is true if `run_termination_payroll` is false and `effective_date` is in the future.
    - `effective_date` string — The employee's last day of work.
    - `run_termination_payroll` 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` 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".
    - `description` string — The description of the garnishment.
    - `court_ordered` boolean — Whether the garnishment is court ordered.
    - `times` integer, nullable — The number of times to apply the garnishment. Ignored if recurring is true.
    - `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.
  - `custom_fields` EmployeeCustomField[] — Custom fields are only included for the employee if the include param has the custom_fields value set
    - `id` string, required
    - `company_custom_field_id` string, required — This is the id of the response object from when you get the company custom fields
    - `name` string, required
    - `type` 'text' | 'currency' | 'number' | 'date' | 'radio', required — Input type for the custom field.
    - `description` string, nullable
    - `value` string, required
    - `selection_options` string[], nullable — An array of options for fields of type radio. Otherwise, null.
  - `date_of_birth` string, nullable
  - `has_ssn` boolean — Indicates whether the employee has an SSN in Gusto.
  - `ssn` string — Deprecated. This field always returns an empty string.
  - `phone` string, nullable
  - `preferred_first_name` string, nullable
  - `payment_method` 'Direct Deposit' | 'Check' — The employee's payment method
  - `current_employment_status` 'full_time' | 'part_time_under_twenty_hours' | 'part_time_twenty_plus_hours' | 'variable' | 'seasonal', nullable — 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.
  - `historical` boolean
  - `employee_code` string — The short format code of the employee
  - `department_uuid` string, nullable — The UUID of the department the employee is under
  - `title` string
  - `hired_at` string, date — The date when the employee was hired to the company
  - `hidden_ssn` string
  - `flsa_status` 'Exempt' | 'Salaried Nonexempt' | 'Nonexempt' | 'Owner' | 'Commission Only Exempt' | 'Commission Only Nonexempt' — 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.
  - `applicable_tax_ids` number[]
  - `member_portal_invitation_status` object, nullable — Member portal invitation status information. Only included when the include param has the portal_invitations value set.
    - `status` 'pending' | 'sent' | 'verified' | 'complete' | 'cancelled' — The current status of the member portal invitation.
    - `token_expired` boolean, nullable — Whether the invitation token has expired.
    - `welcome_email_sent_at` string, date-time, nullable — The date and time when the welcome email was sent.
    - `last_password_resent_at` string, date-time, nullable — The date and time when the password reset was last resent.
  - `partner_portal_invitation_sent` boolean, nullable — Whether an external partner portal invitation webhook has been sent for this employee. Only included when the include param has the portal_invitations value set.

## Other responses

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

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)