Sign in

v1

latestOpenAPI 3.1.02026-07-242892032.8 MB
Earnings Data

Percentile Wages

This endpoint produces a distribution of occupational earnings by percentile

post/v1/us/{datarun}/percentile_wages

Path parameters

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

Specify datarun version

Request body

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

percentilesstring[]

Optional, defaults to [10, 25, 50, 75, 90]. Array of percentiles to calculate. Values should be numeric though represented as strings and in sorted order, low to high.

Response

OK

datarunstring required
yearinteger required
geotypestring required
areasstring[] required
occupationsstring[] required
classesinteger[] required
wage_perstring required