---
title: "Get comp band schema with job tier field configurations and their possible values"
method: GET
path: "/v1/org/{orgId}/band/schema"
tags: ["band"]
---

# Get comp band schema with job tier field configurations and their possible values

`GET /v1/org/{orgId}/band/schema`

## Path parameters

- `orgId` string, required

## Query parameters

- `date` string, date

## Response `200`

successful operation

- CompBandSchema
  - `jobLevelValues` string[], required — Job level values
  - `jobTierOneField` JobTierFieldSchema
    - `code` string — Field code (e.g., department)
    - `values` string[], required — All possible values for this field across comp bands
  - `jobTierTwoField` JobTierFieldSchema
    - `code` string — Field code (e.g., department)
    - `values` string[], required — All possible values for this field across comp bands
  - `jobTierThreeField` JobTierFieldSchema
    - `code` string — Field code (e.g., department)
    - `values` string[], required — All possible values for this field across comp bands
  - `fields` string[], required — List of available compensation fields that have non-null values across comp bands

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)