Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Jobs and Compensations

Get a job

Get a job.

Note: Compensation data (pay rate, payment unit, and related fields) represents sensitive employee pay information. When retrieving employee job data, these fields (rate, payment_unit, current_compensation_uuid, compensations) are only returned when the compensations:read scope is included. This allows you to access employee and job metadata without exposing pay rates.

Compensation data in the response requires the compensations:read scope.

scope: jobs:read

get/v1/jobs/{job_id}

Path parameters

job_idstring required

The UUID of the job

Query parameters

include'all_compensations'

Available options:

  • all_compensations: Include all effective dated compensations for each job instead of only the current compensation

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

versionstring

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

employee_uuidstring

The UUID of the employee to which the job belongs.

hire_datestring

The date when the employee was hired or rehired for the job.

titlestring nullable

The title for the job.

primaryboolean

Whether this is the employee's primary job. The value will be set to true unless an existing job exists for the employee.

ratestring

The employee's pay rate for this job (e.g., hourly wage or annual salary). This is sensitive compensation data and requires the compensations:read scope.

payment_unitstring nullable

How the employee is paid for this job (e.g., Hour, Week, Month, Year, Paycheck). This is sensitive compensation data and requires the compensations:read scope.

current_compensation_uuidstring

The UUID of the current active compensation record for this job. Requires the compensations:read scope.

two_percent_shareholderboolean

Whether the employee owns at least 2% of the company.

state_wc_coveredboolean nullable

Whether this job is eligible for workers' compensation coverage in the state of Washington (WA).

state_wc_class_codestring nullable

The risk class code for workers' compensation in Washington state. Please visit Washington state's Risk Class page to learn more.

location_uuidstring

The uuid of the employee's work location.