---
title: "Get levels and bands status"
method: GET
path: "/api/v1/pay-grades-and-bands/status"
tags: ["Public API"]
---

# Get levels and bands status

`GET /api/v1/pay-grades-and-bands/status`

Get the validation status of each step in the levels and bands configuration wizard.

OAuth Scopes: pay_grades_and_bands

## Response `200`

Successful response

- LevelsAndBandsLevelsAndBandsStatus — Object for compensation level groups and levels
  - `levels` LevelsAndBandsStepStatus, required — Object for compensation level groups and levels
    - `isComplete` boolean, required — Whether the step is complete
    - `errors` LevelsAndBandsErrorWarningIdentifier[], required — Array of errors
      - `groupId` integer, required — Group ID
      - `levelId` integer, required — Level ID
    - `warnings` LevelsAndBandsErrorWarningIdentifier[], required — Array of warnings
      - `groupId` integer, required — Group ID
      - `levelId` integer, required — Level ID
  - `payBands` LevelsAndBandsStepStatus, required — Object for compensation level groups and levels
    - `isComplete` boolean, required — Whether the step is complete
    - `errors` LevelsAndBandsErrorWarningIdentifier[], required — Array of errors
      - `groupId` integer, required — Group ID
      - `levelId` integer, required — Level ID
    - `warnings` LevelsAndBandsErrorWarningIdentifier[], required — Array of warnings
      - `groupId` integer, required — Group ID
      - `levelId` integer, required — Level ID
  - `jobTitles` LevelsAndBandsJobTitlesStatus, required — Object for compensation level groups and levels
    - `isComplete` boolean, required — Is the job titles step complete
    - `errors` string[], required — Array of errors
    - `warnings` LevelsAndBandsJobTitlesCollection[], required — Array of warnings
  - `review` LevelsAndBandsStepStatus, required — Object for compensation level groups and levels
    - `isComplete` boolean, required — Whether the step is complete
    - `errors` LevelsAndBandsErrorWarningIdentifier[], required — Array of errors
      - `groupId` integer, required — Group ID
      - `levelId` integer, required — Level ID
    - `warnings` LevelsAndBandsErrorWarningIdentifier[], required — Array of warnings
      - `groupId` integer, required — Group ID
      - `levelId` integer, required — Level ID

## Other responses

- `403` — Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)