GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference
These docs are for v2024-03-01. Click to read the latest docs for v2026-02-01.

Get employees of a company

get
https://api.gusto-demo.com/v1/companies//employees

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

scope: employees:read

Path Params
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
boolean

Filters employees by the provided boolean

uuids
array of strings

Optional subset of employees to fetch.

uuids
integer

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

integer

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

string

A string to search for in the object's names

Headers
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.

Updated 5 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago