ACH Transactions1

Bank Accounts5

Companies18

Company Attachment4

Company Benefits13

Company Forms4

Contractor Documents4

Contractor Forms4

Contractor Payment Groups8

Contractor Payment Method4

Contractor Payments9

Contractors14

Departments7

Earning Types4

Employee Addresses10

Employee Benefits11

Employee Employments10

Employee Forms5

Employee Payment Method6

Employee Tax Setup4

Employees13

Events1

External Payrolls9

Federal Tax Details2

Flows1

Garnishments5

Generated Documents1

Holiday Pay Policies7

I-9 Verification7

Industry Selection2

Information Requests1

Introspection2

Invoices1

Jobs and Compensations10

Locations5

Member Portal Invitations6

Notifications2

Pay Schedules9

Payment Configs2

Payroll Cancellations2

Payroll Digests2

Payrolls20

People Batches2

Recovery Cases2

Reimbursements5

Reports7

Reverse Wire Transactions1

Salary Estimates5

Signatories5

Tax Payments2

Tax Requirements3

Time Off Policies9

Time Off Requests9

Webhooks8

Wire In Requests3

Contractors

Get a contractor

Changed on Nov 3, 2026

Get a contractor.

scope: contractors:read

get/v1/contractors/{contractor_uuid}

Request

Base URL
https://api.gusto-demo.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/gusto/apis/gusto-api/docs/v1/contractors/:contractor_uuid/get.ts
A function with typed inputs. Its response is checked against the schema.

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.

work_emailstring nullable

The work email address of the contractor. This is provided to support syncing users between our system and yours. You may not use this email address for any other purpose (e.g. marketing).

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

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.

company_namestring

The name of the company the contractor is associated with. Only included when the include param has the company_name value set.

Example response

{
  "hourly_rate": "50.0"
}

Changes

Nov 3, 2026f98575fa2a5e Revision changes
- breaking
  the response's body type changed from object to no type for status
- breaking
  removed the required property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added subschema #2 to the response body allOf list for the response status

Operation history