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.

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

include

array of strings

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
current_home_address: Include the employee's current home address
all_home_addresses: Include all home addresses that have been associated to this employee

include

Allowed:

terminated

boolean

Filters employees by the provided boolean

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

search_term

string

A string to search for in the object's names

Headers

X-Gusto-API-Version

string

enum

Defaults to 2024-03-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

404

Not Found

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

200example response