---
title: "Employment at Wage by Occupation"
method: POST
path: "/v1/us/{datarun}/employment_at_wage_by_occ"
tags: ["Earnings Data"]
---

# Employment at Wage by Occupation

`POST /v1/us/{datarun}/employment_at_wage_by_occ`

This endpoint is similar to the `employment_at_wage` endpoint but produces results per occupation.

This enables the client to see which occupations have the most jobs at or below a specified wage.

## Path parameters

- `datarun` '2025.2' | '2025.1' | '2024.4' | '2024.3' | '2024.2', required

## Request body

- object
  - `areas` string[], required — One or more FIPS codes (if `geotype` is `fips`) or ZIP codes (if `geotype` is `zip`).
  - `classes` integer[], required — One or more class of worker codes.
  - `geotype` 'fips' | 'zip', required — Either `fips` for the FIPS geography taxonomy (nation/state/county) or `zip` for ZIP codes
  - `occupations` string[] — One or more codes from the SOC occupation taxonomy. Defaults to all occupations if not provided
  - `wage_per` 'hourly' | 'annual' — Specify wage type.
  - `wages` string[], required — Array of wages to estimate employment at. Values should be numeric though represented as strings and in sorted order, low to high.
  - `year` integer — Earnings year to aggregate; must be one of the available years for the selected datarun. Defaults to latest year
  - `topN` integer — How many occupations (sorted descending by employment) to return for each wage level. Defaults to `10`

## Response `200`

OK

- object
  - `areas` string[], required
  - `by_occupation` object[]
    - `occupation` string
    - `employment_at_wages` object[]
      - `percentile` string
      - `wage` number
  - `classes` integer[], required
  - `datarun` string, required
  - `employment_at_wages` object[], required
    - `percentile` string
    - `wage` number
  - `geotype` string, required
  - `occupations` string[], required
  - `topN` integer — How many occupations (sorted descending by employment) to return for each wage level. Defaults to `10`
  - `wage_per` string, required
  - `year` string, required

---

[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)