Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Jobs and Compensations

Get compensations for a job

Compensations contain information on how much is paid out for a job. Jobs may have many compensations, but only one that is active. The current compensation is the one with the most recent effective_date.

Note: Currently the API does not support creating multiple compensations per job - creating a compensation with the same job_uuid as another will fail with a relevant error.

Use flsa_status to determine if an employee is eligible for overtime By default the API returns only the current compensation - use the include parameter to return all compensations.

scope: compensations:read

get/v1/jobs/{job_id}/compensations

Path parameters

job_idstring required

The UUID of the job

Query parameters

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

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 compensation in Gusto.

versionstring

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

job_uuidstring

The UUID of the job to which the compensation belongs.

employee_uuidstring

The UUID of the employee to which the compensation belongs.

ratestring

The dollar amount paid per payment unit.

payment_unit'Hour' | 'Week' | 'Month' | 'Year' | 'Paycheck'

The unit accompanying the compensation rate. If the employee is an owner, rate should be 'Paycheck'.

flsa_status'Exempt' | 'Salaried Nonexempt' | 'Nonexempt' | 'Owner' | 'Commission Only Exempt' | 'Commission Only Nonexempt'

The FLSA status for this compensation. Salaried ('Exempt') employees are paid a fixed salary every pay period. Salaried with overtime ('Salaried Nonexempt') employees are paid a fixed salary every pay period, and receive overtime pay when applicable. Hourly ('Nonexempt') employees are paid for the hours they work, and receive overtime pay when applicable. Commissioned employees ('Commission Only Exempt') earn wages based only on commission. Commissioned with overtime ('Commission Only Nonexempt') earn wages based on commission, and receive overtime pay when applicable. Owners ('Owner') are employees that own at least twenty percent of the company.

titlestring

The job title for this compensation.

effective_datestring

The effective date for this compensation. For the first compensation, this defaults to the job's hire date.

adjust_for_minimum_wageboolean

Indicates if the compensation could be adjusted to minimum wage during payroll calculation.