Percentile Wages

post

https://earnings.emsicloud.com/v1/us/{datarun}/percentile_wages

This endpoint produces a distribution of occupational earnings by percentile

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

datarun

string

enum

required

Specify datarun version

Allowed:

Body Params

areas

array of strings

required

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

areas*

classes

array of integers

required

One or more class of worker codes.

classes*

geotype

string

enum

required

length ≥ 1

Either fips for the FIPS geography taxonomy (nation/state/county) or zip for ZIP codes

Allowed:

occupations

array of strings

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

occupations

percentiles

array of strings

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.

percentiles

wage_per

string

enum

Defaults to hourly

Specify wage type.

Allowed:

year

integer

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

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

The bearer token is missing, expired, or invalid. The response has no body.

403

The bearer token is valid but does not carry the occearn scope. The response has no body.

503

The coprocessors that carry out the calculation are not all running, so the service cannot answer the request. The response has no body. GET /status reports the same condition.

Language

Credentials

OAuth2

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

200The earnings distribution for the requested percentiles.

400The request body is missing or failed validation. A body that could not be read at all produces an empty response; a body whose areas, occupations, or classes are not present in the datarun produces a JSON array of messages.

404The requested datarun is not one of the dataruns the service has loaded.

500The request was accepted but the service could not complete it.