Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Contractors

Get contractors of a company

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

scope: contractors:read

get/v1/companies/{company_uuid}/contractors

Path parameters

company_uuidstring required

The UUID of the company

Query parameters

search_termstring

A string to search for in the object's names

sort_bystring
Example:created_at:asc

Sort by one or more fields. Options: created_at, type, onboarding_status, name. Append :asc or :desc to specify direction (e.g., created_at:asc). Defaults to ascending.

onboardedboolean

Filters contractors by those who have completed onboarding

onboarded_activeboolean

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

terminatedboolean

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

terminated_todayboolean

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

includestring[]

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

pageinteger

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

perinteger

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

Headers

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

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

Response

Successful

uuidstring required

The UUID of the contractor in Gusto.

company_uuidstring

The UUID of the company the contractor is employed by.

wage_type'Fixed' | 'Hourly'

The contractor's wage type, either "Fixed" or "Hourly".

is_activeboolean

The status of the contractor with the company.

versionstring

The current version of the object. See the versioning guide for information on how to use this field.

type'Individual' | 'Business'

The contractor's type, either "Individual" or "Business".

first_namestring nullable

The contractor’s first name. This attribute is required for “Individual” contractors and will be ignored for “Business” contractors.

last_namestring nullable

The contractor’s last name. This attribute is required for “Individual” contractors and will be ignored for “Business” contractors.

middle_initialstring nullable

The contractor’s middle initial. This attribute is optional for “Individual” contractors and will be ignored for “Business” contractors.

business_namestring nullable

The name of the contractor business. This attribute is required for “Business” contractors and will be ignored for “Individual” contractors.

einstring nullable

The Federal Employer Identification Number of the contractor business. This attribute is optional for “Business” contractors and will be ignored for “Individual” contractors.

has_einboolean nullable

Whether company's Employer Identification Number (EIN) is present

emailstring nullable

The contractor’s email address. This attribute is optional for “Individual” contractors and will be ignored for “Business” contractors.

start_datestring

The contractor's start date.

hourly_ratestring

The contractor’s hourly rate. This attribute is required if the wage_type is “Hourly”.

file_new_hire_reportboolean nullable

The boolean flag indicating whether Gusto will file a new hire report for the contractor

work_statestring nullable

State where the contractor will be conducting the majority of their work for the company. This value is used when generating the new hire report.

onboardedboolean

The updated onboarding status for the contractor

onboarding_status'admin_onboarding_incomplete' | 'admin_onboarding_review' | 'self_onboarding_not_invited' | 'self_onboarding_invited' | 'self_onboarding_started' | 'self_onboarding_review' | 'onboarding_completed'

One of the "onboarding_status" enum values.

payment_method'Direct Deposit' | 'Check' nullable

The contractor's payment method.

has_ssnboolean

Indicates whether the contractor has an SSN in Gusto.

department_uuidstring nullable

The UUID of the department the contractor is under

departmentstring nullable

The contractor's department in the company.

department_titlestring nullable

The title of the contractor's department.

dismissal_datestring nullable

The contractor's dismissal date.

dismissal_cancellation_eligibleboolean

Whether the contractor's pending dismissal can be cancelled.

rehire_cancellation_eligibleboolean

Whether the contractor's pending rehire can be cancelled.

partner_portal_invitation_sentboolean nullable

Whether an external partner portal invitation webhook has been sent for this contractor. Only included when the include param has the portal_invitations value set.

Example response

[
  {
    "hourly_rate": "50.0"
  }
]