Get employees of a company

get

https://api.gusto-demo.com/v1/companies/{company_id}/employees

Get all of the employees, onboarding, active and terminated, for a given company.

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 returned only when the compensations:read scope is included. This allows you to access employee and job metadata without exposing pay rates.

scope: employees:read

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

company_id

string

required

The UUID of the company

Query Params

location_uuid

string

Filter employees by a specific primary work location

payroll_uuid

string

Filter employees by a specific payroll

search_term

string

A string to search for in the object's names

sort_by

string

Sort employees by field. Cannot be used with search_term. Options: created_at, name, onboarding_status

include

array of strings

Include the requested attribute(s) in each employee response. Multiple options are comma separated.

Show Details

all_compensations	Include all effective dated compensations for each job instead of only the current compensation. Requires `compensations:read` scope.
all_home_addresses	Include all home addresses that have been associated to this employee
company_name	Include the name of the company that the employee is associated with
current_home_address	Include the employee's current home address
custom_fields	Include employees' custom fields
portal_invitations	Include portal invitation status information, including member portal invitation details and partner portal invitation status

include

onboarded

boolean

Filters employees by those who have completed onboarding

onboarded_active

boolean

Filters employees who are ready to work (onboarded AND active today)

terminated

boolean

Filters employees by those who have been or are scheduled to be terminated

terminated_today

boolean

Filters employees by those who have been terminated and whose termination is in effect today (excludes active and scheduled to be terminated)

uuids

array of strings

Optional subset of employees to fetch.

uuids

page

integer

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

per

integer

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

Headers

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

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

Allowed:

Responses

200successful

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