Pay Grades & Bands
Public API

Get Job Titles and Level Assignments

Changed on

Returns 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

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

Request

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 4acdbb25aa278f9f94b44b42ef9f1b27 removed and replaced with get-job-title-level-assignments

    • info

      api tag Pay Grades & Bands added

    • 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