GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Get contractors of a company

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

Get all contractors, active and inactive, individual and business, for a company.

scope: contractors:read

Path Params
string
required

The UUID of the company

Query Params
string

A string to search for in the object's names

string

Sort contractors. Options: type, onboarding_status, name, created_at

boolean

Filters contractors by those who have completed onboarding

boolean

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

boolean

Filters contractors by those who have been or are scheduled to be dismissed

boolean

Filters contractors by those who have been dismissed and whose dismissal is in effect today (excludes active and scheduled to be dismissed)

include
array of strings

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

Show Details
company_nameInclude the name of the company that the contractor is associated with
portal_invitationsInclude portal invitation status information, including member portal invitation details and partner portal invitation status
include
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

Headers
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

Updated 4 months ago

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