---
title: "Get Compensation Level Group Status Counts"
method: GET
path: "/api/v1/pay-grades-and-bands/status-counts"
tags: ["Pay Grades & Bands", "Public API"]
---

# Get Compensation Level Group Status Counts

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

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/pay-grades-and-bands/status-counts`
- Auth: OAuth 2
  - Authorization code: `/authorize.php`
  - Token URL: `/token.php` scopes: `pay_grades_and_bands`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/pay-grades-and-bands/status-counts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the number of compensation level groups in each lifecycle status. The response is a JSON object of integer counts keyed by status: `draft`, `historic`, and `published`. When a published baseline exists, the `draft` count includes only draft groups that have at least one visited setup step (groups the user has actually started editing), not every draft group; when no published groups exist, it counts all draft groups. Use this for a tally of how many groups sit in each status; for the overall setup configuration status (whether each setup step is complete, with its blocking errors and warnings), use Get Levels and Bands Status (`get-levels-and-bands-status`) instead.

OAuth Scopes: pay_grades_and_bands

## Response `200`

Compensation level group counts by status, as a JSON object with integer `draft`, `historic`, and `published` counts.

- LevelsAndBandsGroupStatusCounts: Schema for levels and bands group status counts
  - `draft` integer: Number of compensation level groups in draft status
  - `historic` integer: Number of compensation level groups in historic status
  - `published` integer: Number of compensation level groups in published status

## Other responses

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

## Changes

- **2026-11-03** `922fc15f43a7`: 2 info
  - api operation id `99b887959832c80eead3a176acc0c2d4` removed and replaced with `get-compensation-level-group-status-counts`
  - api tag `Pay Grades & Bands` added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/pay-grades-and-bands/status-counts/get.md)

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)