List Job Titles with Employees
Changed onReturns every active, non-archived company job title (not only titles used in the pay grades and bands configuration) together with the employees who currently hold each title. The response is a JSON array of job title objects; each carries the job title id, its title name, and an employees array. Each employee entry exposes the internal employee ID (id here; the same identifier is employeeId on List Employees and eeid on the employee dataset) alongside the employee display name. This internal employee ID is not the editable Employee # (employeeNumber); using employeeNumber in its place may resolve to a different employee. An employee is omitted from a title's employees array when the authenticated caller lacks permission to view a required employee field (name, job title, or id), so an empty employees array does not necessarily mean no one holds that title; it can also mean the caller cannot see the employees who do. The array is empty when no job titles exist. This is a read-only view. Use this to see which employees occupy each job title; for the draft assignment of job titles to compensation levels (which returns no employee data), use Get Job Titles and Level Assignments (get-job-title-level-assignments) 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
Job titles with the employees holding each, as a JSON array. Empty only when the company has no active, non-archived job titles.
Changes
- warning
removed the optional property
/from the response with the status - info
api operation id
3af7d1ac36c35008b8ebb93fecbdb35bremoved and replaced withlist-job-titles-with-employees - info
api tag
Pay Grades & Bandsadded
- warning