---
title: "Benchmark an occupation"
method: POST
path: "/dimensions/{dimension}"
tags: ["Dimensions"]
---

# Benchmark an occupation

`POST /dimensions/{dimension}`

## Request

- Base URL: `https://api.lightcast.io/occupation-benchmark`
- URL: `https://api.lightcast.io/occupation-benchmark/dimensions/{dimension}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `occupation-benchmark`

Benchmark an occupation.

## Path parameters

- `dimension` 'lotocc' | 'lotspecocc', required

## Query parameters

- `lot_version` '6' | '7'
- `nation` string

## Request body

- object
  - `id` string, required
  - `region` object
    - `nation` string, required
    - `level` string: This must come with a corresponding region id.
    - `id` string: This must come with a corresponding region level.
  - `datasets` string[]

## Response `200`

OK

- object
  - `data` object, required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `region` object, required
      - `nation` string, required
      - `id` string, required
      - `name` string, required
      - `level` string, required
    - `taxonomicalInfo` object
      - `taxonomy` string, required
      - `level` integer, required
      - `levelName` string, required
      - `hierarchy` object[], required
        - `id` string, required
        - `name` string, required
        - `level` integer, required
        - `levelName` string, required
    - `jobLevel` integer, nullable: Job level is base on the level of education, experience, and training required to qualify for the occupation.
    - `typicalEducation` object, nullable
      - `id` string, required
      - `name` string, required
    - `riskScore` number, nullable: Higher scores indicate higher risk of automation for this occupation.
    - `locationQuotient` number, nullable: A measure of the significance of the occupation in the given region compared to that of the nation.
    - `education` object[], nullable
      - `id` string, required
      - `name` string, required
      - `count` integer, required
      - `percentage` number, required
    - `experience` object, nullable
      - `mean` number, nullable, required
      - `distribution` object[], required
        - `key` string, required: Description of the values binned under this key.
        - `value` number, required: Value of the bin under the specified key.
    - `salary` object, nullable
      - `mean` integer, nullable, required
      - `distribution` object[], required
        - `key` string, required: Description of the values binned under this key.
        - `value` number, required: Value of the bin under the specified key.
    - `demand` object, nullable
      - `count` integer, required: Number of job postings advertising in the last 12 months.
      - `level` string, required: Relative level of demand for this occupation compared to other occupations.
    - `employment` object, nullable
      - `growth` number, required
      - `series` array[], required
        - object[]
    - `similarOccupations` object[], nullable
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `score` number, required
    - `specializedSkills` object[], nullable
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `commonSkills` object[], nullable
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `certifications` object[], nullable
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `definingSkills` object[], nullable: Skills that are fundamental to the occupation.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `distinguishingSkills` object[], nullable: Skills that distinguish workers in the occupation.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `necessarySkills` object[], nullable: Skills that are generally required for the occupation.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `salaryBoostingSkills` object[], nullable: Skills that lend themselves to increased salaries in this occupation.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `count` integer, required
      - `percentage` number, required
    - `employers` object[], nullable
      - `id` string, required
      - `name` string, required
      - `count` integer, required
      - `percentage` number, required
    - `titles` object[], nullable
      - `id` string, required
      - `name` string, required
      - `count` integer, required
      - `percentage` number, required
    - `advancementOccupations` object[], nullable: Other occupations that the occupation can lead into.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `category` string, required
      - `score` number, required
      - `meanSalary` number, required
      - `meanSalaryDiff` number, required
      - `jobLevel` integer, required
      - `jobLevelDiff` integer, required
    - `lateralOccupations` object[], nullable: Other occupations that can be relatively easily transitioned into from the occupation.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `category` string, required
      - `score` number, required
      - `meanSalary` number, required
      - `meanSalaryDiff` number, required
      - `jobLevel` integer, required
      - `jobLevelDiff` integer, required
    - `feederOccupations` object[], nullable: Other occupations that can lead into the occupation.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `category` string, required
      - `score` number, required
      - `meanSalary` number, required
      - `meanSalaryDiff` number, required
      - `jobLevel` integer, required
      - `jobLevelDiff` integer, required

## Other responses

- `400`: Your request wasn't valid (bad parameter names or values).
- `404`: The dimension you requested wasn't found.

---

[API](https://skmtc.dev/lightcast/apis/occupation-benchmark.md) - [All operations](https://skmtc.dev/lightcast/apis/occupation-benchmark/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/occupation-benchmark/revisions/51b48df28452?raw)