---
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`

## Request

- Base URL: `https://api.lightcast.io/alumni-pathways`
- URL: `https://api.lightcast.io/alumni-pathways/v1/us/{datarun}/employment_at_wage_by_occ`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `alumni-pathways`

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.dev/lightcast/apis/alumni-pathways-2-0.md) - [All operations](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/alumni-pathways-2-0/revisions/fc66b9877391?raw)