v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

Earnings Data

Employment at Wage by Occupation

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.

post/v1/us/{datarun}/employment_at_wage_by_occ

datarun'2025.2' | '2025.1' | '2024.4' | '2024.3' | '2024.2' required

Specify datarun version

areasstring[] required

One or more FIPS codes (if geotype is fips) or ZIP codes (if geotype is zip).

classesinteger[] 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

occupationsstring[]

One or more codes from the SOC occupation taxonomy. Defaults to all occupations if not provided

wage_per'hourly' | 'annual'

Specify wage type.

wagesstring[] required

Array of wages to estimate employment at. Values should be numeric though represented as strings and in sorted order, low to high.

yearinteger

Earnings year to aggregate; must be one of the available years for the selected datarun. Defaults to latest year

topNinteger

How many occupations (sorted descending by employment) to return for each wage level. Defaults to 10

areasstring[] required

classesinteger[] required

datarunstring required

geotypestring required

occupationsstring[] required

topNinteger

How many occupations (sorted descending by employment) to return for each wage level. Defaults to 10

wage_perstring required

yearstring required