Get Job Titles and Level Assignments
Changed onReturns the working draft configuration showing which job titles are assigned to each compensation level, as used by the pay grades and bands setup wizard. When no draft configuration exists, the endpoint returns the currently published configuration instead. The response is a JSON object with a groups array; each group carries its levels, and each level lists the jobTitles assigned to it alongside its pay band flattened into min, mid, max, and percentageRange value objects (each wrapping a numeric value plus its own errors and warnings), currencyCode, and compensationType. The per-group and per-level errors and warnings arrays are always empty on this view; job-title assignment issues are reported by Get Levels and Bands Status (get-levels-and-bands-status) instead. Each job title carries a job title identifier and its name; no employee data is included. To see which employees currently hold each job title, use List Job Titles with Employees (list-job-titles-with-employees) instead. This is a read-only view. For the same group/level tree focused on level configuration use List Compensation Level Groups and Levels (list-compensation-level-groups-and-levels), for pay band values use Get Pay Bands (get-pay-bands), and for the published configuration without validation state use Get Published Levels and Bands (get-published-levels-and-bands) instead.
OAuth Scopes: pay_grades_and_bands
Request
- Base URLhttps://companySubDomain.bamboohr.com
- AuthOAuth 2Authorization code/authorize.phpToken URL/token.phpScopespay_grades_and_bands
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Response
The working pay grades and bands configuration (the draft when one exists, otherwise the currently published configuration): job-title-to-level assignments with validation state, as an object with a groups array.
Changes
- breaking
the response property
became optional for 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
api operation id
4acdbb25aa278f9f94b44b42ef9f1b27removed and replaced withget-job-title-level-assignments - info
api tag
Pay Grades & Bandsadded - info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
added the optional property
////to the response with the status - info
added the optional property
////to the response with the status - info
added the optional property
////to the response with the status - info
added the optional property
////to the response with the status - info
added the optional property
////to the response with the status - info
added the optional property
////to the response with the status - info
added the optional property
//to the response with the status
- breaking