---
title: "Get compensation benchmark data"
method: POST
path: "/compensation"
tags: ["Compensation"]
---

# Get compensation benchmark data

`POST /compensation`

Lightcast models compensation data using government data and advertised salary observations identified from job postings data. Compensation data is based on the last year of active postings.

Advanced filtering is available for this endpoint. For more details, take a look at [Advanced Filtering](#advanced-filtering) section of this documentation.

## Request body

- Schema — unresolved $ref

## Response `200`

OK

- object
  - `searchParams` object, required
    - `area` union, required — This field will return a list of area objects if `advanced` filter was used. Otherwise, it will be an area object.
      - object
        - `id` string, required
        - `name` string, required
        - `level` string, required
      - object[]
        - `id` string, required
        - `name` string, required
        - `level` string, required
    - `title` object, nullable, required
      - `id` string, nullable, required
      - `name` string, nullable, required
    - `occupations` object[], required
      - `id` string, required
      - `name` string, required
    - `skills` object[], required
      - `id` string, required
      - `name` string, required
  - `data` object, required
    - `summary` object, required
      - `benchmarkIndex` number, nullable, required — Our compensation benchmark index is a multiplier, comparing regional compensation to national compensation. `1.0` indicates the region is on par with national compensation `null` indicates a lack of information to estimate the index.
      - `maxSalary` integer, nullable, required — `null` if compensation data does not exist for given filters.
      - `minSalary` integer, nullable, required — `null` if compensation data does not exist for given filters.
      - `medianSalary` integer, nullable, required — `null` if compensation data does not exist for given filters.
      - `medianAdvertisedSalary` integer, nullable, required — `null` if compensation data does not exist for given filters.
      - `wageRating` string, nullable, required — `null` if there's no modeled wage rating or insufficient data for given filters. Only MSA areas are modeled at this time.
    - `percentiles` object[], required
      - `percentile` integer, required
      - `regional` integer, required
      - `national` integer, required

## Other responses

- `400` — bad request
- `401` — unauthorized request
- `404` — requested resource not found

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)