Pay Grades & Bands
Public API

List Job Titles with Employees

Changed on

Returns 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

get/api/v1/pay-grades-and-bands/job-titles-with-employees

Request

Response

Job titles with the employees holding each, as a JSON array. Empty only when the company has no active, non-archived job titles.

idinteger

Job title identifier.

titlestring

Job title name.

Changes

    • warning

      removed the optional property / from the response with the status

    • info

      api operation id 3af7d1ac36c35008b8ebb93fecbdb35b removed and replaced with list-job-titles-with-employees

    • info

      api tag Pay Grades & Bands added