v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

Earnings Data

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?"

post/v1/us/{datarun}/employment_at_wage

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

areasstring[] required

classesinteger[] required

datarunstring required

geotypestring required

occupationsstring[] required

wage_perstring required

yearstring required