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

# Employment at Wage

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

This endpoint produces estimates of the number of jobs currently at or below the specified wages.

This allows the client to answer questions such as "how many forklift drivers are willing to work for 12.50 an hour?"

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

## Response `200`

OK

- object
  - `areas` string[], required
  - `classes` integer[], required
  - `datarun` string, required
  - `employment_at_wages` object[], required
    - `percentile` string
    - `wage` number
  - `geotype` string, required
  - `occupations` string[], required
  - `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)