Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Contractors

Get a contractor

Get a contractor.

scope: contractors:read

get/v1/contractors/{contractor_uuid}

Path parameters

contractor_uuidstring required

The UUID of the contractor

Query parameters

includestring[]

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

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"
}